视频生成 API 使用说明（凭证用户版）

BASE=https://alliex.space
CRED=XXXX-XXXX-XXXX        # 换成你的卡密或 dbk_ API Key

# ① 提交文转视频任务
curl -s $BASE/api/video \
  -H "Authorization: Bearer $CRED" -H "Content-Type: application/json" \
  -d '{"prompt":"一只小猫追蝴蝶，阳光下的草地","ratio":"9:16","duration":10,"mode":"t2v"}'

# ② 用返回的 job id 查状态（等待 status=done）
curl -s $BASE/api/video/<job_id> -H "Authorization: Bearer $CRED"

# ③ 查出片（命中该会话素材），再下载
curl -s -X POST $BASE/api/video/<job_id>/query -H "Authorization: Bearer $CRED"
curl -s -o out.mp4 "$BASE/api/assets/media/job/<job_id>?item=0&filename=out.mp4" \
  -H "Authorization: Bearer $CRED"

# ④ 随时查剩余次数
curl -s $BASE/api/card/info -H "Authorization: Bearer $CRED"

{
  "ok": true,
  "code": "dbk_11cb9459",
  "quota": 5,
  "quota_display": 5,
  "used": 0,
  "reserved": 1,
  "remaining": 4,
  "status": "active",
  "created": 1786691041,
  "last_used": null,
  "kind": "api"
}

{
  "prompt": "夕阳下的海边，海浪拍打礁石",
  "ratio": "9:16",
  "duration": 10,
  "mode": "t2v",
  "count": 2
}

{
  "prompt": "30秒音乐跳舞视频，16:9，先是个人solo，出场顺序为第一 @参考图4【D】 、第二 @参考图3【C】 、第三 @参考图1【A】 ，然后 @参考图2【B】 @参考图5【E】 同时出场。最后 @参考图1【A】 和 @参考图2【B】 分别牵着 @参考图4【D】 和 @参考图3【C】 的手一起跳起来",
  "ratio": "16:9",
  "duration": 30,
  "mode": "r2v",
  "count": 1,
  "images": [
    { "store_uri": "tos-cn-i-a9rns2rl98/053569abe5ca4db5b410121c9ad40b44.png", "name": "A.png", "account": 0 },
    { "store_uri": "tos-cn-i-a9rns2rl98/cd38141b2a0044e1a47b621cc1a7a0e1.png", "name": "B.png", "account": 0 },
    { "store_uri": "tos-cn-i-a9rns2rl98/067674a008234440a46b3b97198e8f3c.png", "name": "C.png", "account": 0 },
    { "store_uri": "tos-cn-i-a9rns2rl98/17a12e2112824eddbf02994254d2ec8c.png", "name": "D.png", "account": 0 },
    { "store_uri": "tos-cn-i-a9rns2rl98/5f775b8a6d0e4ef28ea50ae6037b9f76.png", "name": "E.png", "account": 0 }
  ]
}

{
  "jobs": [
    {
      "id": "8ef298d3abab",
      "status": "queued",
      "prompt": "30秒音乐跳舞视频，16:9，先是个人solo，出场顺序为第一 @参考图4【D】 、第二 @参考图3【C】 、第三 @参考图1【A】 ，然后 @参考图2【B】 @参考图5【E】 同时出场。最后 @参考图1【A】 和 @参考图2【B】 分别牵着 @参考图4【D】 和 @参考图3【C】 的手一起跳起来",
      "ratio": "16:9",
      "duration": 30,
      "mode": "r2v",
      "image_uris": [
        "tos-cn-i-a9rns2rl98/eca87887a4e4487b9816b9213607f83f.png",
        "tos-cn-i-a9rns2rl98/4078242fe44a418ebf5504f7f4938482.png",
        "tos-cn-i-a9rns2rl98/e7d4f9ae0e2f481486dc3eff1eb8aada.png",
        "tos-cn-i-a9rns2rl98/0a4cacf8f77c4fd98bee7e2414b8f6d4.png",
        "tos-cn-i-a9rns2rl98/2c79e935999d472ea582e1c9a80dc34e.png"
      ],
      "image_names": ["A.png", "B.png", "C.png", "D.png", "E.png"],
      "image_name": null,
      "created": 1786691107,
      "done_at": null,
      "progress": "",
      "error": null,
      "detail": "任务已排队",
      "attempts": 0
    }
  ]
}

{ "error": "prompt 不能为空" }                                    // 400
{ "error": "server_busy" }                                        // 409 服务器额度繁忙，稍后重试
{ "error": "卡密剩余额度不足（剩余 X 次，本次需 N 次）" }          // 403
{ "error": "凭证无效" }                                           // 401

curl -s $BASE/api/video/<job_id> -H "Authorization: Bearer $CRED"

queued → accepting → generating → done | error

{
  "id": "8ef298d3abab",
  "status": "generating",
  "prompt": "30秒音乐跳舞视频，16:9，先是个人solo，出场顺序为第一 @参考图4【D】 、第二 @参考图3【C】 、第三 @参考图1【A】 ，然后 @参考图2【B】 @参考图5【E】 同时出场。最后 @参考图1【A】 和 @参考图2【B】 分别牵着 @参考图4【D】 和 @参考图3【C】 的手一起跳起来",
  "ratio": "16:9",
  "duration": 30,
  "mode": "r2v",
  "image_uris": [ "…（同上，5 个）…" ],
  "image_names": ["A.png", "B.png", "C.png", "D.png", "E.png"],
  "image_name": null,
  "created": 1786691107,
  "done_at": null,
  "progress": "视频正在生成中，耐心等待",
  "error": null,
  "detail": "已受理，正在生成视频",
  "attempts": 1
}

{
  "id": "8ef298d3abab",
  "status": "done",
  "prompt": "30秒音乐跳舞视频，16:9，先是个人solo，出场顺序为第一 @参考图4【D】 、第二 @参考图3【C】 、第三 @参考图1【A】 ，然后 @参考图2【B】 @参考图5【E】 同时出场。最后 @参考图1【A】 和 @参考图2【B】 分别牵着 @参考图4【D】 和 @参考图3【C】 的手一起跳起来",
  "ratio": "16:9",
  "duration": 30,
  "mode": "r2v",
  "image_uris": [ "…（同上，5 个）…" ],
  "image_names": ["A.png", "B.png", "C.png", "D.png", "E.png"],
  "image_name": null,
  "created": 1786691107,
  "done_at": 1786691562,
  "progress": "视频成功生成，本次用时：7分钟35秒，点击右下角查询按钮获取视频",
  "error": null,
  "detail": "视频已生成",
  "attempts": 1
}

curl -s -X POST $BASE/api/video/<job_id>/query -H "Authorization: Bearer $CRED"

{ "ok": false, "error": "暂未查询到该任务视频，请耐心等待或者重新提交" }

{
  "ok": true,
  "video_items": [
    {
      "type": "video",
      "name": "video.mp4",
      "node_id": "52603089981680386",
      "key": "v0269cg10004d9vburi7dldfo4tpdu40",
      "message_id": "52601107523635458",
      "conversation_id": "38437745109779458",
      "duration": 30.042,
      "create_time": 1786691502,
      "ai_skill_status": 0,
      "width": 1280,
      "height": 720,
      "account_index": 32,
      "has_src": true,
      "has_cover": true,
      "ext": ".mp4"
    }
  ],
  "total": 1,
  "items": [ "…（与 video_items 同结构）…" ]
}

# 下载第 0 个素材（带文件名 → 浏览器/工具会存成文件）
curl -s -o out.mp4 "$BASE/api/assets/media/job/<job_id>?item=0&filename=out.mp4" \
  -H "Authorization: Bearer $CRED"

# 取封面（kind=cover；无封面回退素材本体）
curl -s -o cover.jpg "$BASE/api/assets/media/job/<job_id>?item=0&kind=cover&filename=cover.jpg" \
  -H "Authorization: Bearer $CRED"

# 打包素材为一个 ZIP（items 可加多项，本次实测只打 1 个视频）
curl -s -X POST $BASE/api/assets/pack/job/<job_id> \
  -H "Authorization: Bearer $CRED" -H "Content-Type: application/json" \
  -d '{"items":[{"index":0,"type":"video"}]}' -o all.zip

HTTP 200；ZIP 内文件：8ef298d3abab_video_1.mp4（36513771 字节，视频按 STORED 存储）
下载单素材 out.mp4：36513771 字节，合法 MP4（30 秒 1280×720）

# 单张
curl -s -F "file=@ref.png" $BASE/api/upload -H "Authorization: Bearer $CRED"

# 批量 .zip（压缩包内多张图片）
curl -s -F "file=@refs.zip" $BASE/api/upload-zip -H "Authorization: Bearer $CRED"

{
  "store_uri": "tos-cn-i-a9rns2rl98/053569abe5ca4db5b410121c9ad40b44.png",
  "name": "A.png",
  "size": 1596779,
  "account_index": 0
}

curl -s $BASE/api/video \
  -H "Authorization: Bearer $CRED" -H "Content-Type: application/json" \
  -d '{"prompt":"让画面中的人物跳起舞来","mode":"r2v","images":[{"store_uri":"tos-cn-i-a9rns2rl98/053569abe5ca4db5b410121c9ad40b44.png","name":"a.png","account":0}]}'

python api_client.py --base https://alliex.space --api-key XXXX-XXXX-XXXX \
  --prompt "一只小猫追蝴蝶" --ratio 9:16 --duration 10 --mode t2v

import asyncio
from api_client import VideoGenAPI

async def main():
    api = VideoGenAPI(base_url="https://alliex.space", api_key="XXXX-XXXX-XXXX")
    # 提交文转视频，拿到任务
    jobs = await api.submit("一只小猫追蝴蝶", ratio="9:16", duration=10, mode="t2v")
    job_id = jobs[0]["id"]
    # 轮询直到出片 / 失败（默认最多等 35 分钟）
    job = await api.wait_for_done(job_id)
    if job.get("status") != "done":
        print("任务失败：", job.get("error"))
        return
    # 查出片并下载第 0 个素材
    await api.query(job_id)
    await api.download_asset(job_id, item=0, out_path="out.mp4")

asyncio.run(main())

from curl_cffi import requests
from curl_cffi import CurlMime

s = requests.Session(impersonate="chrome")   # 模拟 Chrome TLS 指纹
BASE = "https://alliex.space"
H = {"Authorization": "Bearer XXXX-XXXX-XXXX"}

# 提交文转视频（json= 用法同 requests）
r = s.post(f"{BASE}/api/video", headers=H,
           json={"prompt": "一只小猫追蝴蝶", "ratio": "9:16", "duration": 10, "mode": "t2v"})

# 上传参考图：curl_cffi 的 multipart 必须传 CurlMime() 对象，不能用普通 dict / files=
mime = CurlMime(s)
mime.addpart(name="file", filename="ref.png", local_path="ref.png", content_type="image/png")
r = s.post(f"{BASE}/api/upload", headers=H, multipart=mime)
data = r.json()
store_uri = data.get("store_uri")   # 成功以 store_uri 存在为准（响应无 ok 字段）