Skip to main content

​
模型对比

模型分辨率支持文生视频图生视频-首帧图生视频-首尾帧
doubao-seedance-1-0-pro-250528480p/720p/1080p✅✅✅
doubao-seedance-1-0-pro-fast-251015480p/720p/1080p✅✅❌

​
参数说明

​
基础参数（必填）

参数名类型说明可选值
modelstring模型名称doubao-seedance-1-0-pro-fast-251015 / doubao-seedance-1-0-pro-250528
promptstring文本提示词中英文描述，建议≤500字
resolutionstring视频分辨率480p / 720p / 1080p
默认：1080p
ratiostring视频宽高比16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive
durationinteger视频时长（秒）2~12秒

​
可选参数

参数名类型默认值说明适用场景
imagesarray-图片URL数组
• 单张图片 = 首帧
• 两张图片 = 首尾帧		首尾帧仅 doubao-seedance-1-0-pro-250528 支持
fpsinteger-视频帧率24
seedinteger-1随机种子
• -1 表示随机
• 取值范围：[-1, 2³²-1]		全部模型
watermarkbooleanfalse是否添加水印true / false
camerafixedbooleanfalse相机固定
固定镜头，减少运镜幅度		true / false

​
文生视频

通过文本描述生成视频。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer {YOUR_API_KEY}" \
   -d '{
     "model": "doubao-seedance-1-0-pro-fast-251015",
     "prompt": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索,手里拿起桌上的某个物品。镜头转向他正在思索。",
     "resolution": "480p",
     "ratio": "16:9",
     "duration": 10,
     "fps": 24,
     "watermark": true,
     "seed": 11,
     "camerafixed": false
   }'
视频生成为异步任务，您需要使用返回的 task_id 来查询生成结果。

​
图生视频-首帧

基于首帧图片生成视频。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "doubao-seedance-1-0-pro-fast-251015",
    "prompt": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 10,
    "fps": 24,
    "watermark": true,
    "seed": 11,
    "camerafixed": false
  }'

​
图生视频-首尾帧

基于首尾两帧图片生成视频（仅 doubao-seedance-1-0-pro-250528 支持）。 
curl -X POST https://{YOUR_API_ENDPOINT}/v1/video/generations \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer {YOUR_API_KEY}" \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "prompt": "360度环绕运镜",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
    ],
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 10,
    "fps": 24,
    "watermark": true,
    "seed": 11,
    "camerafixed": false
}'

​
查询视频任务

使用任务ID查询视频生成结果。 
curl https://{YOUR_API_ENDPOINT}/v1/video/generations/{task_id} \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer {YOUR_API_KEY}"

​
任务状态说明

状态说明
PENDING任务排队中
PROCESSING任务处理中
SUCCESS任务成功完成
FAILED任务失败
视频生成任务的执行时间取决于队列长度和视频时长，通常需要几分钟时间。