创建视频

通过统一接口提交视频生成任务，支持可灵、即梦等国产视频生成模型。视频生成是异步任务，提交后返回任务 ID（task_id），再用任务 ID 查询生成进度。

一、接口信息

• 接口用途：提交视频生成任务（支持文生视频、图生视频）
• 请求方式：POST
• 请求地址：https://www.yunshukjai.com/v1/video/generations
• 鉴权方式：Authorization: Bearer YOUR_API_KEY

二、请求参数

参数	类型	必填	说明
model	string	是	模型名称，以控制台「模型广场」为准，例如 kling-v1
prompt	string	是	视频内容描述，建议写清主体、动作、场景和画质要求
image	string	否	图生视频时的参考图（图片 URL 或 Base64）
duration	number	否	视频时长（秒）
width / height	integer	否	视频宽度 / 高度
fps	integer	否	视频帧率
seed	integer	否	随机种子，固定种子可复现结果
n	integer	否	生成视频数量
response_format	string	否	响应格式
user	string	否	用户标识
metadata	object	否	扩展参数，如 negative_prompt、style、quality_level、aspect_ratio 等

不同模型支持的参数不同，具体请以「模型广场」中对应模型的说明为准。

三、请求示例

（一）文生视频

curl https://www.yunshukjai.com/v1/video/generations \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v1",
    "prompt": "一只橘猫趴在窗台上晒太阳，阳光柔和，电影质感，高清画质",
    "duration": 5
  }'

（二）图生视频

curl https://www.yunshukjai.com/v1/video/generations \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng_vgfm_i2v_l20",
    "prompt": "让图片中的海浪动起来，镜头缓慢推进",
    "image": "https://example.com/sea.jpg",
    "metadata": {
      "aspect_ratio": "16:9"
    }
  }'

（三）豆包 Seedance 参考写法

豆包视频模型支持通过 seconds 和 metadata 传扩展参数，例如 ratio（画面比例）和 resolution（分辨率）：

curl https://www.yunshukjai.com/v1/video/generations \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "宇航员在月球表面慢慢行走，地球悬挂在黑色天空中，画面宏大震撼",
    "seconds": "-1",
    "metadata": {
      "ratio": "16:9",
      "resolution": "720p"
    }
  }'

模型名称和 metadata 支持的参数以「模型广场」中对应模型的说明为准。

四、响应示例

提交成功返回：

{
  "id": "video_123",
  "object": "video",
  "model": "kling-v1",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

其中 task_id 是后续查询进度的唯一凭证，请保存好。

五、注意事项

• 视频生成是异步任务，提交后需要轮询获取视频任务进度，任务完成后到获取视频内容下载视频。
• 模型名称必须与「模型广场」完全一致，否则会提示模型不存在。
• 图生视频时建议使用高清、主体清晰的参考图，效果更好。
• 如果返回 401，请检查 API Key 是否正确；返回 400 请检查参数是否符合模型要求。

平台同时提供 OpenAI 兼容的视频创建接口 POST /v1/videos（multipart/form-data，支持 prompt、model、seconds、size、input_reference 等参数），可按需使用。

相关文档

• 获取视频任务进度
• 获取视频内容