视频生成 · 快速开始

视频生成是异步任务：先提交，拿到任务 ID，再轮询查询，完成后下载。一条视频通常需要几分钟到几十分钟，不同线路差别很大，可在 模型广场 查看各模型说明。

准备

需要一个选择了 seedance - 视频渠道 或 minimax - 视频渠道 分组的 API 密钥，见 接入总览。

第 1 步：提交任务

curl https://www.apophiscode.com/v1/videos \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-768p-按秒",
    "prompt": "清晨，阳光穿过森林，镜头缓慢向前推进",
    "seconds": "6",
    "size": "1280x720"
  }'

返回任务对象，记下 id：

{
  "id": "task_xxxxxxxxxxxx",
  "object": "video",
  "model": "MiniMax-H3-768p-按秒",
  "status": "queued",
  "progress": 0,
  "created_at": 1794372000
}

第 2 步：查询进度

每 10–20 秒查询一次，直到 status 变为 completed 或 failed：

curl https://www.apophiscode.com/v1/videos/task_xxxxxxxxxxxx \
  -H "Authorization: Bearer sk-你的密钥"

status	含义
queued	已受理，排队或提交上游中
in_progress	生成中
completed	生成成功，可以下载
failed	失败，原因见 error.message，费用已退回

第 3 步：下载视频

curl -L https://www.apophiscode.com/v1/videos/task_xxxxxxxxxxxx/content \
  -H "Authorization: Bearer sk-你的密钥" \
  -o video.mp4

及时保存

生成结果由上游缓存，保留时间有限，完成后请尽快下载保存。下载失败时重新查询原任务即可，不要重新提交，否则会再次扣费。

下一步：查看 接口说明 了解参考图、首尾帧、参考视频等全部参数。