Seedance 是火山引擎的视频生成模型,支持文生视频、图生视频、视频到视频等多种模式。

可用模型

支持的统一入参

统一字段支持说明
modelmodel
promptcontent[] 中的 { type: "text", text }
imagecontent[] 中的 image_url
videocontent[] 中的 video_url
audiocontent[] 中的 audio_url
ratioratio16:94:31:13:49:1621:9adaptive
resolutionresolution480p720p(全型号);1080p(Seedance 2.0 Fast / Mini 不支持);4k(仅 Seedance 2.0 支持)
headers自定义 HTTP 请求头

upstream_options 支持的参数

参数类型支持模型说明
callback_urlstring全部任务状态变更回调地址。当视频生成任务有状态变化时,方舟将向此地址推送 POST 请求
return_last_frameboolean全部是否返回生成视频的尾帧图像(png 格式,无水印)。可用于连续视频生成:以上一个视频的尾帧作为下一个任务的首帧
service_tier'default' | 'flex'全部服务等级:default 在线推理(低配额,高时效);flex 离线推理(高配额,价格为 50%)
execution_expires_afternumber全部任务超时时间(秒),从创建时间起算。默认 172800(48h),范围 [3600, 259200]
generate_audioboolean全部是否生成与画面同步的声音(人声、音效、背景音乐)。建议对话部分置于双引号内以优化效果
draftboolean全部是否开启样片模式。true 时生成预览视频快速验证效果,消耗 token 更少,成本更低
toolsArray<{ type: string }>仅 Seedance 2.0 系列工具定义,如联网搜索:[{ "type": "web_search" }]
safety_identifierstring全部终端用户唯一标识符(≤64 字符),用于协助平台检测违规使用。推荐传入哈希后的值
prioritynumber全部请求执行优先级,0~9,数值越大优先级越高。高优先级请求将插队到同 Endpoint 下低优先级请求之前
durationnumber全部生成视频时长(秒):1.0 Pro / 1.0 Pro Fast: [2, 12];1.5 Pro: [4, 12] 或 -1;2.0 系列: [4, 15] 或 -1
framesnumber全部生成视频帧数,[29, 289],需满足 25+4n 格式(n 为正整数)。帧数 = 时长 × 24
seednumber全部随机种子,[-1, 2^32-1]。相同 seed 生成类似结果(不保证完全一致),-1 为随机
camera_fixedboolean全部是否固定摄像头。true 时平台会在 prompt 中追加固定摄像头指令,实际效果不保证
watermarkboolean全部是否包含水印。false 不含水印,true 时右下角展示"AI 生成"水印

媒体入参映射

媒体输入参数处理规则:

用户传入处理结果
image: "https://..."{ "type": "image_url", "image_url": { "url": "..." }, "role": "reference_image" }
image: { "type": "first_frame", "url": "..." }{ "type": "image_url", "image_url": { "url": "..." }, "role": "first_frame" }
video: "https://..."{ "type": "video_url", "video_url": { "url": "..." }, "role": "reference_video" }
video: { "type": "reference_video", "url": "..." }{ "type": "video_url", "video_url": { "url": "..." }, "role": "reference_video" }
audio: "https://..."{ "type": "audio_url", "audio_url": { "url": "..." }, "role": "reference_audio" }
audio: { "type": "reference_audio", "url": "..." }{ "type": "audio_url", "audio_url": { "url": "..." }, "role": "reference_audio" }

数组会逐项展开;字符串使用默认 role,对象使用对象上的 type 作为 role。

示例:文生视频

curl -X POST https://ai.win10030.com/video/v1/generations \
  -H 'Authorization: Bearer sk-xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "prompt": "一只金毛犬在海边奔跑,夕阳逆光,慢动作",
    "resolution": "720p",
    "ratio": "16:9",
    "upstream_options": {
      "duration": 5,
      "watermark": false,
      "service_tier": "default"
    }
  }'

示例:视频输入

curl -X POST https://ai.win10030.com/video/v1/generations \
  -H 'Authorization: Bearer sk-xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "prompt": "基于参考视频生成续集,保持人物和场景一致",
    "video": { "type": "reference_video", "url": "https://example.com/reference.mp4" },
    "resolution": "720p",
    "upstream_options": { "duration": 5 }
  }'

示例:多模态参考(图片 + 视频 + 音频)

curl -X POST https://ai.win10030.com/video/v1/generations \
  -H 'Authorization: Bearer sk-xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-1-0-pro-250528",
    "prompt": "根据首帧、参考视频和背景音乐生成广告片",
    "image": { "type": "first_frame", "url": "https://example.com/first.jpg" },
    "video": "https://example.com/reference.mp4",
    "audio": "https://example.com/bgm.mp3",
    "resolution": "1080p",
    "ratio": "16:9",
    "upstream_options": {
      "duration": 8,
      "generate_audio": true,
      "watermark": false
    }
  }'

计费

Seedance 使用 billingMethod: "modality_tokens"

请求是否包含 video对客价格字段用量字段
output_tokens_pricingusage.output_tokens
input_video_output_tokens_pricingusage.output_tokens

has_input_video 只由统一请求体的 video 字段判断:非空字符串、非空 URL 对象或数组中任一有效视频即为 true