视频生成 · Catcoder 原生格式

如果你的程序已经按 Catcoder Video API 的格式编写，可以使用本站的兼容路径，只需修改地址、密钥和模型名，请求体字段保持不变。新接入推荐使用 OpenAI 兼容接口。

操作	方法与路径
提交任务	`POST /catcoder/v1/videos/generations`
查询任务	`GET /catcoder/v1/videos/{task_id}`

提交

curl https://www.apophiscode.com/catcoder/v1/videos/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance2.5-720p-按秒-Z",
    "prompt": "黄昏时分，湖面与芦苇轻轻摇动",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

请求字段与接口说明中的扩展参数相同（model、prompt、duration、resolution、aspect_ratio、images、videos、audio、video_durations、first_frame、end_frame、video_mode、generate_audio、watermark、return_last_frame、web_search、seed），其他字段会被拒绝。

返回 HTTP 202：

{ "id": "task_OifPpKWEu00tgXTaovnTBUUwzGOZatP4", "status": "created" }

查询

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

{
  "id": "task_OifPpKWEu00tgXTaovnTBUUwzGOZatP4",
  "status": "succeeded",
  "created_at": 1794372000,
  "download_url": "https://www.apophiscode.com/..."
}

status	含义
`created` / `submitting` / `queued`	已受理，等待上游处理
`processing`	生成中
`succeeded`	成功，从 `download_url` 下载
`failed`	失败，原因见 `error_code`、`error_msg`，费用已退回

官转模型完成后还会返回 video_usage（实际 token 用量、时长、分辨率）。

与 Catcoder 官方文档的区别

项目	本站
模型名	使用本站模型名，见模型能力
任务 ID	统一为本站 `task_…` 编号，没有 `vid_` / `cgt-` 编号切换
`Idempotency-Key`	不需要传，本站会替你处理上游幂等；超时请先查询，不要重复提交
素材上传（`/v1/seedance/asset/*`、`asset://`）	暂不支持，请使用公网 HTTPS 链接
图片生成接口	暂不提供
下载	使用返回的 `download_url`，带本站密钥请求

提交​

查询​

与 Catcoder 官方文档的区别​

提交

查询

与 Catcoder 官方文档的区别