视频生成开放接口
文生视频 / 图生视频 / 视频生视频,自带音轨。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、路径、状态码、耗时),在控制台可查。
能力与限制
| 模式 | mode | 需要上传 | 说明 |
|---|---|---|---|
| 文生视频 | t2v | 否 | 纯提示词出片 |
| 图生视频 | i2v | 图片 | 以这张图为首帧续动 |
| 视频生视频 | v2v | 视频 | 以参考视频做重绘 / 编辑 |
| 项 | 限制 |
|---|---|
时长 seconds | 2 ~ 15 秒(模型训练范围约 5-15 秒,太短画面会糊) |
分辨率 mp | 0.2 ~ 1.05 百万像素,原生 768p(1344×768 ≈ 1.03MP) |
画幅 ratio | 16:9 9:16 1:1 4:3 3:4,默认 16:9 |
| 上传大小 | 图片 ≤ 30MB,视频 ≤ 200MB |
| 并发 | 全站一条串行队列,同一时刻只跑一条,排队不计费 |
| 耗时 | 3 秒 480p 约 120 秒;时长、分辨率、步数越高越久 |
| 计费 | 按显卡实际占用秒数扣金币,余额低于 100 直接拒绝开跑。平台侧故障(连不上显卡、作业挂了)不收费;素材或参数导致模型报错照常按秒计 |
| Key 数量 | 每个账号最多 20 把 |
| 任务保留 | 最近 300 条,超出自动淘汰,视频文件随之清理 |
提交任务
请求体为 multipart/form-data。
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
mode | string | i2v | t2v / i2v / v2v |
prompt | string | 必填 | 大白话即可,服务端会套 H3 官方提示词结构;最长 4000 字 |
file | file | — | i2v/v2v 必填,t2v 不要传 |
seconds | float | 5 | 2 ~ 15 |
mp | float | 0.4 | 0.2 ~ 1.05 |
ratio | string | 16:9 | 画幅 |
seed | int | -1 | -1 表示随机,响应里会返回实际用的种子 |
turbo | bool | true | 挂加速 LoRA,步数从 20-25 降到 4-8,快很多;关掉画质略好 |
keep_audio | bool | true | 保留模型生成的音轨 |
smart | bool | true | 智能模式:先让 VLM 读懂素材再编排提示词,慢几分钟但更听话 |
响应:
{"task_id": "7f3a9c1b2d4e", "queue_len": 2, "seed": 182736451}
提交是立刻返回的:素材只落本地盘,往显卡节点的上传放在任务里做,
所以 200MB 的视频也不会把请求挂在那儿超时。上传失败不会变成 HTTP 错误,
而是这条任务的 status 变 error,原因在 error 字段里。
查询任务
建议 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
}
下载视频
{video} 用上一步返回的 video 字段。返回 video/mp4 字节流。
只能取自己账号的任务,别人的一律 404。
其它接口
看卡在不在、显存、队列长度。接入方做熔断用。
{"ok": true, "device": "BW", "vram_total_mb": 65520, "vram_free_mb": 64562, "queue_len": 0}
列自己最近的任务。
删任务和它的视频文件。进行中的任务删不掉,返回 409。
错误与失败
| 状态码 | 含义 | 怎么办 |
|---|---|---|
| 400 | 参数不对:提示词为空、模式未知、文件超限、该传文件没传 | 按提示改参数 |
| 401 | Key 无效、已停用,或账号被停用 | 在上面重新签发一把 |
| 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"], "秒")
调用记录
每一次带 Key 的请求都会留痕:时间、账号、接口、来源 IP、耗时、状态码。 认不出的 Key 也记——账号为空的那些行,就是有人拿错 Key 在敲门。 在控制台 经典控制台 顶栏的「接口 Key」里按 Key 查。