视频生成

统一的视频任务入口。不同模型支持的时长、比例、分辨率和参考素材数量可能不同。

POST /v1/videos

创建视频任务

通用参数

参数	类型	必填	说明
model	string	是	视频模型 ID，见图片/视频模型目录
prompt	string	是	场景、主体动作、镜头运动、风格及声音描述
duration	integer	否	视频秒数，以模型支持范围为准
aspect_ratio	string	否	常见值 16:9、9:16、1:1、4:3、3:4
resolution	string	否	如 480p、720p、1080p、4k
image_url	string	否	单张首帧或参考图片 URL
image_urls	string[]	否	多张参考图片 URL
image_with_roles	array	否	显式指定 first_frame、last_frame、reference_image
generate_audio	boolean	否	支持的模型可生成同步音频
seed	integer	否	随机种子

文生视频

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "海浪拍打海岸，镜头缓慢向前推进，电影感光线",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "generate_audio": true
  }'

首帧图生视频

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-video-3",
    "prompt": "人物缓慢转身看向镜头，镜头轻微推进",
    "duration": 6,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://your-domain.example/first-frame.png", "role": "first_frame"}
    ]
  }'

响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "generation.task",
  "model": "doubao-seedream-4-0",
  "status": "queued",
  "progress": 0
}

参数由模型决定

通用入口会传递图片和视频参数，但并非每个视频模型都支持全部字段。收到 400 时先检查所选模型的时长、比例与参考素材约束。