织影

视频生成开放接口

文生视频 / 图生视频 / 视频生视频,自带音轨。HTTP 调用,一把 API Key 就能接。

概览

服务地址 https://aikey.biz,所有响应为 JSON(下载视频除外),编码 UTF-8。 调用是异步的:提交拿到 task_id → 轮询状态 → 完成后取 mp4。

POST /api/video/submit   ──►  {"task_id": "..."}
GET  /api/video/task/{id} ──►  status: queued → running → done
GET  /api/video/file/{v}  ──►  video/mp4

获取 API Key

在这里自助签发,不用找人要。一个账号可以有多把,按用途分开发,出事只停一把。

加载中…

鉴权

Key 形如 sk-aikey-xxxxxxxx…,每次请求二选一带上:

Authorization: Bearer sk-aikey-xxxxxxxx...
X-API-Key: sk-aikey-xxxxxxxx...

Key 等同于该账号的身份:任务归属、金币扣费、历史记录都算在这个账号上。 服务端只保存 Key 的 SHA-256,明文只在签发那一刻显示一次,丢了只能重发一把。 每次调用都会记进调用记录(时间、来源 IP、路径、状态码、耗时),在控制台可查。

Key 泄露就等于别人在花你的金币。放服务端环境变量,别写进前端代码或仓库。发现异常自己停用,几秒生效。

能力与限制

模式mode需要上传说明
文生视频t2v否纯提示词出片
图生视频i2v图片以这张图为首帧续动
视频生视频v2v视频以参考视频做重绘 / 编辑
项限制
时长 seconds2 ~ 15 秒(模型训练范围约 5-15 秒,太短画面会糊)
分辨率 mp0.2 ~ 1.05 百万像素,原生 768p(1344×768 ≈ 1.03MP)
画幅 ratio16:9 9:16 1:1 4:3 3:4,默认 16:9
上传大小图片 ≤ 30MB,视频 ≤ 200MB
并发全站一条串行队列,同一时刻只跑一条,排队不计费
耗时3 秒 480p 约 120 秒;时长、分辨率、步数越高越久
计费按显卡实际占用秒数扣金币,余额低于 100 直接拒绝开跑。平台侧故障(连不上显卡、作业挂了)不收费;素材或参数导致模型报错照常按秒计
Key 数量每个账号最多 20 把
任务保留最近 300 条,超出自动淘汰,视频文件随之清理
只有一张卡、一条队列。接入前按「每小时 20-30 条」估算吞吐,别按并发设计调用方。

提交任务

POST/api/video/submit

请求体为 multipart/form-data。

字段类型默认说明
modestringi2vt2v / i2v / v2v
promptstring必填大白话即可,服务端会套 H3 官方提示词结构;最长 4000 字
filefile—i2v/v2v 必填,t2v 不要传
secondsfloat52 ~ 15
mpfloat0.40.2 ~ 1.05
ratiostring16:9画幅
seedint-1-1 表示随机,响应里会返回实际用的种子
turbobooltrue挂加速 LoRA,步数从 20-25 降到 4-8,快很多;关掉画质略好
keep_audiobooltrue保留模型生成的音轨
smartbooltrue智能模式:先让 VLM 读懂素材再编排提示词,慢几分钟但更听话

响应:

{"task_id": "7f3a9c1b2d4e", "queue_len": 2, "seed": 182736451}

提交是立刻返回的:素材只落本地盘,往显卡节点的上传放在任务里做, 所以 200MB 的视频也不会把请求挂在那儿超时。上传失败不会变成 HTTP 错误, 而是这条任务的 status 变 error,原因在 error 字段里。

查询任务

GET/api/video/task/{task_id}

建议 5 秒轮询一次。status 走 queued → running → done,失败为 error。

{
  "id": "7f3a9c1b2d4e",
  "mode": "i2v", "mode_name": "图生视频",
  "status": "done", "stage": "完成",
  "prompt": "模特转身展示连衣裙背面",
  "seconds": 5, "mp": 0.4, "seed": 182736451, "turbo": true,
  "video": "7f3a9c1b2d4e.mp4",      // 取件用的文件名,done 之后才有
  "error": null,
  "charged": 148,                    // 本次实扣金币
  "gpu_seconds": 147.2,              // 显卡占用秒数(计费依据)
  "vlm_seconds": 63.0,               // 智能模式的理解耗时,平台承担,不计费
  "run_seconds": 210.4, "elapsed": 243.1,
  "created_at": 1761460000.12
}

下载视频

GET/api/video/file/{video}?download=1

{video} 用上一步返回的 video 字段。返回 video/mp4 字节流。 只能取自己账号的任务,别人的一律 404。

其它接口

GET/api/video/health

看卡在不在、显存、队列长度。接入方做熔断用。

{"ok": true, "device": "BW", "vram_total_mb": 65520, "vram_free_mb": 64562, "queue_len": 0}
GET/api/video/tasks?limit=30

列自己最近的任务。

DELETE/api/video/task/{task_id}

删任务和它的视频文件。进行中的任务删不掉,返回 409。

错误与失败

状态码含义怎么办
400参数不对:提示词为空、模式未知、文件超限、该传文件没传按提示改参数
401Key 无效、已停用,或账号被停用在上面重新签发一把
402金币不足(低于 100 不开跑)充值
404任务或视频不存在,或不属于你核对 id
409任务进行中,不能删等它跑完
—素材上传失败、显卡掉线、作业重启:不是 HTTP 错误,是任务 status=error重新提交;持续失败看 /api/video/health,这类不扣费

完整示例

curl:文生视频

KEY=sk-aikey-xxxxxxxx

# 1. 提交
curl -s -X POST https://aikey.biz/api/video/submit \
  -H "Authorization: Bearer $KEY" \
  -F mode=t2v \
  -F prompt='一位模特在影棚缓缓转身,米白色长裙,自然光' \
  -F seconds=5 -F mp=0.4 -F ratio=16:9

# 2. 轮询(把 TASK 换成上一步的 task_id)
curl -s -H "Authorization: Bearer $KEY" https://aikey.biz/api/video/task/$TASK

# 3. 取件
curl -s -H "Authorization: Bearer $KEY" \
  -o out.mp4 "https://aikey.biz/api/video/file/$TASK.mp4?download=1"

Python:图生视频,提交到落盘

import time, requests

BASE = "https://aikey.biz"
H = {"Authorization": "Bearer sk-aikey-xxxxxxxx"}

r = requests.post(f"{BASE}/api/video/submit", headers=H, timeout=120,
                  data={"mode": "i2v", "prompt": "模特转身展示连衣裙背面",
                        "seconds": 5, "mp": 0.4, "turbo": True},
                  files={"file": ("dress.png", open("dress.png", "rb"), "image/png")})
r.raise_for_status()
tid = r.json()["task_id"]

while True:                      # 一条 5 秒 768p 常见 3-6 分钟,排队另算
    t = requests.get(f"{BASE}/api/video/task/{tid}", headers=H, timeout=60).json()
    print(t["status"], t["stage"])
    if t["status"] == "done":
        break
    if t["status"] == "error":
        raise RuntimeError(t["error"])
    time.sleep(5)

mp4 = requests.get(f"{BASE}/api/video/file/{t['video']}?download=1",
                   headers=H, timeout=300).content
open("out.mp4", "wb").write(mp4)
print("扣费", t["charged"], "金币,显卡占用", t["gpu_seconds"], "秒")
轮询别低于 5 秒。队列是串行的,刷得再快也不会更早出片,只会把调用记录冲满。

调用记录

每一次带 Key 的请求都会留痕:时间、账号、接口、来源 IP、耗时、状态码。 认不出的 Key 也记——账号为空的那些行,就是有人拿错 Key 在敲门。 在控制台 经典控制台 顶栏的「接口 Key」里按 Key 查。