curl --request POST \
--url https://kaienapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sora-2"
}
'{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}OpenAI 风格视频任务接口
OpenAI Videos / Sora 兼容接口，公开调用统一使用 application/json。
Seedance 2.0
seedance-2.0：标准版。seedance-2.0-fast：快速版。seedance-2.0-economy：经济版。seedance-2.0-fast-economy：Fast 经济版。
两个经济版模型当前支持 720P，并默认启用人脸一致性检测。Seedance 请求可传 prompt、duration 或 seconds、resolution、ratio（兼容 aspect_ratio）、参考素材和 face_check。经济版多参考图模式支持 8 秒、16:9，建议使用 1K 参考图以提高生成稳定性。实际价格以模型价格页和账单为准。
其他视频模型
| 模型 | 用途 | 固定单次价格 |
|---|---|---|
omni_flash-10s | 10 秒 720p；文生视频、最多 7 个参考图片、视频修改 | 1.1 |
veo_3_1-fast | 文生视频、参考图视频 | 0.7 |
veo_3_1-lite-fl | Lite 首尾帧；images 依次传首帧和尾帧 | 0.72 |
veo_3_1-fast-fl-hd | Fast HD 首尾帧；images 依次传首帧和尾帧 | 0.88 |
执行顺序
POST /v1/videos创建任务。- 保存返回的
id。 GET /v1/videos/{video_id}查询状态。- 状态为
completed后调用GET /v1/videos/{video_id}/content获取视频；状态为failed时读取error。
视频生成是异步任务，建议每 3-5 秒查询一次。
curl --request POST \
--url https://kaienapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sora-2"
}
'{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}授权
在请求头中传入：Authorization: Bearer sk-...
请求体
视频生成请求。/v1/videos 兼容 OpenAI / Sora 风格视频任务，也支持 Seedance 2.0 的 seedance-2.0、seedance-2.0-fast 及对应豆包官方模型别名；/v1/video/generations 是通用视频任务入口。/v1/videos 和 /v1/video/generations 通常需要顶层 prompt；/api/v3/contents/generations/tasks 使用 content 数组。模型扩展字段会随请求提交，或并入 metadata。
视频模型 ID。不同模型的时长、尺寸、参考图和任务查询方式不同。
"sora-2"
视频生成描述。说明主体、动作、镜头、画面环境、时长感、比例和不能改变的元素。
"A short cinematic product video"
视频尺寸或分辨率，例如 1280x720、720x1280。部分模型用 aspect_ratio 或 resolution 表达相同含义。
"720x1280"
Seedance 输出分辨率，例如 480p、720p、1080p 或 4k。也可由部分兼容接口放在 metadata 中。
"720p"
Seedance 输出宽高比，例如 21:9、16:9、4:3、1:1、3:4 或 9:16。也可使用 aspect_ratio 兼容别名。
"16:9"
OpenAI 风格视频接口常用的时长字段，传字符串数字，例如 "4"、"6"。
"4"
通用视频任务常用的时长字段；整数和字符串数字均可提交。
5
单张参考图。可传公网 URL 或 base64，具体以模型说明为准。
多张参考图片或参考视频。使用 JSON 字符串数组，每项可为公网直链或完整 base64 data URI，具体以模型说明为准。Omni 最多支持 7 项；Veo 的 -fl 首尾帧模型按顺序读取第 1、2 项。
参考视频 URL 数组。Seedance 2.0 会按豆包官方 content 结构映射为 role=reference_video 的 video_url；参考视频最多传入 3 个，总时长通常不超过 15 秒，实际限制以官方文档和接口返回为准。
参考音频 URL 数组。Seedance 2.0 会映射为官方 content 中 role=reference_audio 的 audio_url。
Seedance 是否启用人脸一致性检测。标准版省略时默认为 true；Fast 版按产品规则处理。
生成模式。部分模型有 std、pro 等模式，不同模式的价格和耗时可能不同。
"std"
模型扩展参数容器，例如 negative_prompt、cfg_scale、camera_control、aspect_ratio、movement_amplitude、bgm、seed 等。
也可放在 metadata 中；顶层传入时会并入 metadata。
"low quality"
部分视频模型读取；顶层传入时会并入 metadata。
0.5
部分视频模型读取；顶层传入时会并入 metadata。
部分视频模型使用的比例字段；Seedance 推荐使用顶层 ratio，aspect_ratio 作为兼容别名。
"16:9"
响应
任务对象
The response is of type object.