curl --request POST \
--url https://kaienapi.com/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2-master",
"prompt": "A short cinematic product video"
}
'{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}通用视频任务接口
通用视频生成任务接口，创建文生视频、图生视频和带扩展参数的视频任务。
请求格式
使用 application/json。必须包含 model 和 prompt。图生视频使用 image 或 images，具体字段以模型说明为准。
参数要点
duration：生成时长，常见为 5、10 等数字。size/aspect_ratio：分辨率或画面比例。mode：模型模式，例如 std、pro。metadata：模型特有参数，例如镜头控制、负向提示词、运动强度、背景音乐等。
执行顺序
- 调用本接口提交任务。
- 保存返回的任务 ID。
- 用
GET /v1/video/generations/{task_id}查询状态。 - 完成后读取结果 URL，或按返回结构下载文件。
错误定位
- 一直处理中：拉长轮询间隔，并设置超时提示。
- 参数不生效：确认参数应放在顶层还是
metadata。 - 图生视频失败：确认参考图 URL 可访问，或文件字段是否按模型要求上传。
curl --request POST \
--url https://kaienapi.com/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-v2-master",
"prompt": "A short cinematic product video"
}
'{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}Authorizations
在请求头中传入：Authorization: Bearer sk-...
Body
视频生成请求。/v1/videos 兼容 OpenAI / Sora 风格视频任务，也支持 Seedance 2.0 的 seedance-2.0、seedance-2.0-fast 及对应豆包官方模型别名；/v1/video/generations 是通用视频任务入口。模型扩展字段会随请求提交，或并入 metadata。
视频模型 ID。不同模型的时长、尺寸、参考图和任务查询方式不同。
"sora-2"
视频生成描述。说明主体、动作、镜头、画面环境、时长感、比例和不能改变的元素。
"A short cinematic product video"
视频尺寸或分辨率，例如 1280x720、720x1280。部分模型用 aspect_ratio 或 resolution 表达相同含义。
"720x1280"
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。不同模型的支持范围可能不同，实际价格以模型价格页和账单为准。
生成模式。部分模型有 std、pro 等模式，不同模式的价格和耗时可能不同。
"std"
模型扩展参数容器，例如 negative_prompt、cfg_scale、camera_control、aspect_ratio、movement_amplitude、bgm、seed 等。
也可放在 metadata 中；顶层传入时会并入 metadata。
"low quality"
部分视频模型读取；顶层传入时会并入 metadata。
0.5
部分视频模型读取；顶层传入时会并入 metadata。
部分视频模型读取；顶层传入时会并入 metadata。
"16:9"
Response
任务创建结果
The response is of type object.