千支API 文档

视频模型接入指南

视频生成是异步任务接口：先提交任务，拿到任务 ID 后轮询状态，完成后再下载视频内容。 当前站点开放 OpenAI 兼容视频接口和旧版兼容任务接口。

进入控制台 查看模型价格 返回接入文档

1. 当前视频模型

2. 文生视频：创建任务

推荐使用 OpenAI 兼容的 /v1/videos。该接口使用 multipart/form-data，最少需要 model 和 prompt。

curl https://api.qianzhiapi.com/v1/videos \
  -H "Authorization: Bearer sk-你的APIKey" \
  -F "model=video-ds-2.0-fast" \
  -F "prompt=一只白色小猫在阳光下奔跑，电影感，柔和镜头" \
  -F "seconds=8"

成功后会返回类似：

{
  "id": "video-abc123",
  "object": "video",
  "model": "video-ds-2.0-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1785767000,
  "seconds": "8"
}

3. 图生视频：带参考图创建任务

如果模型支持图生视频，可以上传参考图字段 input_reference。 文件字段名按当前 OpenAI 兼容路由填写。

curl https://api.qianzhiapi.com/v1/videos \
  -H "Authorization: Bearer sk-你的APIKey" \
  -F "model=video-ds-2.0-fast" \
  -F "prompt=让图片里的主体缓慢转身，背景有轻微镜头推进" \
  -F "seconds=8" \
  -F "[email protected]"

4. 查询任务状态

任务状态可能是 queued、in_progress、 completed 或 failed。建议每 5 到 10 秒查询一次，不要高频轮询。

curl https://api.qianzhiapi.com/v1/videos/video-abc123 \
  -H "Authorization: Bearer sk-你的APIKey"

5. 下载视频内容

当任务状态为 completed 后，使用 content 接口下载视频文件。

curl https://api.qianzhiapi.com/v1/videos/video-abc123/content \
  -H "Authorization: Bearer sk-你的APIKey" \
  -o output.mp4

6. 旧版兼容 JSON 接口

当前后端仍保留旧版兼容接口。新接入推荐优先用 /v1/videos； 只有老客户端已经按 JSON 任务接口实现时，再使用下面路径。

curl https://api.qianzhiapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-ds-2.0-fast",
    "prompt": "宇航员在月球上慢慢行走，远处是蓝色地球",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

curl https://api.qianzhiapi.com/v1/video/generations/video-abc123 \
  -H "Authorization: Bearer sk-你的APIKey"

7. 常见错误