视频生成 · 接口说明

本站视频接口兼容 OpenAI Videos API 的格式，同时允许在请求体里直接写各模型的扩展参数（参考图、参考视频、首尾帧等）。

操作	方法与路径
提交任务	`POST /v1/videos`
查询任务	`GET /v1/videos/{id}`
下载视频	`GET /v1/videos/{id}/content`

所有请求都需要 Authorization: Bearer sk-你的密钥。

提交任务

POST /v1/videos，Content-Type: application/json。

基础参数

参数	类型	必填	说明
`model`	string	是	模型名，见模型能力
`prompt`	string	是	视频描述，最长 20000 字符
`seconds`	string / number	否	视频时长（秒），必须在模型支持的时长内；不填时默认 5 秒（或模型的最短时长）
`size`	string	否	输出尺寸，如 `1280x720`、`720x1280`。本站会换算成最接近的分辨率和画面比例
`input_reference`	string	否	一张参考图（首帧参考）的 HTTPS 链接

扩展参数

以下参数直接写在请求体顶层。具体是否支持、数量上限是多少，以模型能力为准，超出范围会直接报错，不会扣费。

参数	类型	说明
`resolution`	string	分辨率：`480p` / `720p` / `768p` / `1080p` / `4k`，与 `size` 二选一
`aspect_ratio`	string	画面比例：`16:9` / `9:16` / `4:3` / `3:4` / `1:1` / `21:9`，官转模型还支持 `adaptive`
`duration`	number	与 `seconds` 等价。官转模型可传 `-1` 由模型自动决定时长（按最长时长预扣）
`images`	string[]	参考图片 HTTPS 链接
`videos`	string[]	参考视频 HTTPS 链接
`video_durations`	number[]	每段参考视频的时长（秒），与 `videos` 一一对应。按秒计费且对参考视频收费的模型（如 MiniMax H3）用它预扣，不填按每段 15 秒预扣，完成后按实际时长结算
`audio`	string[]	参考音频 HTTPS 链接
`first_frame`	string	首帧图片 HTTPS 链接（需要模型支持首尾帧）
`end_frame`	string	尾帧图片 HTTPS 链接，必须同时提供 `first_frame`
`video_mode`	string	仅 Seedance 2.5 官转 / 国内官转：`generate`（默认）/ `edit`（编辑参考视频）/ `extend_forward`（向前延长）/ `extend_backward`（向后延长）
`generate_audio`	boolean	官转模型：是否生成有声视频
`return_last_frame`	boolean	官转模型：是否同时返回尾帧图片
`watermark`	boolean	官转模型：是否加水印
`seed`	number	官转模型：随机种子

素材必须是公网 HTTPS 链接

所有图片、视频、音频都必须是无需登录即可直接下载的公网 HTTPS 链接（443 端口，不能带账号密码）。不支持本地文件、Base64、data URL、内网地址或 HTTP 链接。

示例：多张参考图

{
  "model": "Seedance2.0-720p-按秒-gf",
  "prompt": "图1的人物在图2的街道上奔跑，电影感运镜",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "images": [
    "https://cdn.example.com/person.png",
    "https://cdn.example.com/street.png"
  ]
}

示例：首尾帧

{
  "model": "官转-Seedance2.0-特价",
  "prompt": "花朵从含苞到盛开",
  "duration": 5,
  "resolution": "1080p",
  "first_frame": "https://cdn.example.com/bud.png",
  "end_frame": "https://cdn.example.com/bloom.png",
  "generate_audio": true
}

示例：延长视频（Seedance 2.5 官转 / 国内官转）

{
  "model": "官转-Seedance2.5-特价",
  "prompt": "向后延长视频1，人物继续走向远处的灯塔",
  "video_mode": "extend_backward",
  "duration": 5,
  "resolution": "720p",
  "videos": ["https://cdn.example.com/clip.mp4"],
  "video_durations": [8]
}

提交成功返回任务对象，status 一般为 queued：

{
  "id": "task_OifPpKWEu00tgXTaovnTBUUwzGOZatP4",
  "object": "video",
  "model": "Seedance2.0-720p-按秒-gf",
  "status": "queued",
  "progress": 0,
  "created_at": 1794372000
}

参数不合法时直接返回 HTTP 4xx 和错误原因，不会创建任务，也不会扣费。

查询任务

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

{
  "id": "task_OifPpKWEu00tgXTaovnTBUUwzGOZatP4",
  "object": "video",
  "model": "Seedance2.0-720p-按秒-gf",
  "status": "completed",
  "progress": 100,
  "seconds": "8",
  "created_at": 1794372000,
  "completed_at": 1794372420
}

字段	说明
`status`	`queued` 排队 / `in_progress` 生成中 / `completed` 成功 / `failed` 失败
`progress`	进度百分比（部分线路不提供实时进度）
`seconds`	实际视频时长（上游返回时才有）
`completed_at`	完成时间，Unix 秒
`error`	失败时出现：`{ "code": "...", "message": "失败原因" }`

建议每 10–20 秒查询一次。官转模型在视频生成完后还要等上游回报实际 token 用量，状态会在 in_progress 多停留一会儿，属正常现象。

下载视频

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

只有 status 为 completed 的任务可以下载。请加 -L 跟随跳转：部分线路会跳转到上游的视频直链。

注意事项

不要重复提交：网络超时或长时间没有结果时，请先用任务 ID 查询，确认失败后再重新提交。每次提交都是一个新任务，会单独扣费。
任务只能由创建它的账号查询和下载。
也可以在控制台的视频工作台直接在网页上生成视频，效果与 API 相同。

提交任务​

基础参数​

扩展参数​

示例：多张参考图​

示例：首尾帧​

示例：延长视频（Seedance 2.5 官转 / 国内官转）​

返回​

查询任务​

下载视频​

注意事项​