• 与 OpenAI 兼容接口行为一致,路径走 OpenAI 官方别名
  • 部分第三方 SDK 与工具链默认使用这个路径
  • 参数、响应与「视频生成(OpenAI 兼容)」完全相同
POST/v1/videos

认证

string必填

所有接口均使用 Bearer Token 进行认证。

Seedance 系列的接口需要在 ark 站 单独获取 Key,与 api 站的 Key 不通用。

请求时在请求头中添加:

Authorization: Bearer YOUR_ARK_KEY

请求结构

请求体与视频生成(OpenAI 兼容)完全一致:prompt、image、duration、size 等字段平铺在顶层,没有 content 数组。唯一差别是路径多一个 s。

支持的场景

场景字段组合
文生视频prompt
图生视频·首帧prompt + image
图生视频·首尾帧改用豆包原生通道,见视频生成(豆包原生)
全模态参考改用豆包原生通道,见视频生成(豆包原生)
编辑视频改用豆包原生通道,见视频生成(豆包原生)
延长视频改用豆包原生通道,见视频生成(豆包原生)

OpenAI 兼容结构只有 prompt 与 image 两个创作字段,能表达的场景比豆包原生少。需要首尾帧、参考图、视频编辑或延长时,用豆包原生通道提交,任务查询仍然走同一个任务状态接口。

请求参数

string必填

视频模型 ID。

string必填

视频描述。

string可选

首帧图片地址。

integer可选

时长,单位秒。

string可选

输出画幅,像素值或比例字符串。

string可选

完成回调地址。

响应

string

任务 ID。

string

固定为 video。

string

任务状态,提交后为 queued。

integer

创建时间戳。

错误码

HTTP含义
400参数错误,type 为 invalid_request_error
401Token 缺失或无效,type 为 authentication_error
402余额不足,type 为 permission_error
429触发限流

更多状态码与重试建议见错误码与限流,常见报错的排查步骤见常见问题。

与 /v1/video/generations 的关系

两个路径指向同一套逻辑,差异只在路径拼写:

路径说明
/v1/video/generations单数形式,早期版本使用
/v1/videos复数形式,与 OpenAI 官方命名对齐

已有代码用哪个都能跑。新项目建议用复数形式,与 OpenAI 生态保持一致。

支持的模型列表

以下视频模型均可通过本接口提交任务,清单只列各厂商最新一代,实际可用范围以你的账号分组为准:

Seedance 系列

  • seedance-2.5旗舰,支持音画同步
  • seedance-2.0上一代主力
  • seedance-2.0-fast快速版
  • seedance-2.0-mini轻量,成本最低 等

更多模型持续更新中…

各型号的能力差异:

项目2.0 家族2.5
最长时长15 秒30 秒
分辨率480p / 720p / 1080p / 4k480p / 720p / 1080p

2.0 家族里 fast 与 mini 只支持 480p 与 720p,4K 仅 2.0 标准版可用。

完整模型目录(含时长上限、音画能力)可读取 GET https://ark.oairoute.com/api/pricing。

使用示例

基础提交

/v1/videos 与 /v1/video/generations 参数完全一致,只是路径多了一个 s。两条都能用,选一条固定下来即可。

带首帧

image 按首帧处理,提示词描述后续运动。首帧建议与目标画面比例一致,否则会被裁剪。

异步回调

服务端处理耗时较长时用回调,避免客户端长时间轮询。