Seedance 2.0 视频生成 | API 文档

创建 Seedance 2.0 异步任务。Seedance 2.5 的参数见独立文档。

鉴权

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

modelstring必填

seedance-2.0 或别名 seedance-2-0。

promptstring

视频提示词。纯文本生成时必填；有图片或视频素材时可省略或留空。不能只提供音频。metadata.content 中的 text 项会被丢弃，仅使用此顶层提示词。

secondsstring默认: 5

"4" 到 "15" 的整数字符串，也接受数值别名 duration。同时提供时必须一致；不支持 -1 自动时长。

sizestring默认: 720p

输出分辨率：480p、720p、1080p 或 4k，不是宽高比。分辨率优先级为 metadata.resolution、size、resolution。

aspectRatiostring默认: 16:9

16:9、9:16、1:1、4:3、3:4、21:9、adaptive。接受别名 aspect_ratio、ratio；metadata.ratio 优先。同一设置请仅使用一种别名。

metadataobject

接受 resolution、ratio、content 和 generate_audio。 generate_audio 是控制生成音频的布尔值，顶层 generateAudio / generate_audio 为别名；请仅提供一个音频生成控制项。

imagesstring[]

图片简写：第一张对应首帧，第二张对应尾帧。精确角色请用 metadata.content。原有 imageUrls、imageUrl、image_urls、 image_url 别名继续支持，同样使用首尾帧语义。

imageWithRolesobject[]

包含 url 和 role 的图片，角色为 first_frame、last_frame、 reference_image，别名为 image_with_roles。两个版本也均支持 typed metadata.content。

videoUrlsstring[]

参考视频，接受 videoUrl、video_urls、video_url 别名。

audioUrlsstring[]

参考音频，接受 audioUrl、audio_urls、audio_url 别名。同一请求必须同时有图片或视频。

callback_urlstring

可选的原生回调地址，是否回调取决于所选通道。请以 GET https://api.requestbeam.com/v1/jobs/{jobId} 查询结果为准。

多模态素材

metadata.content 的媒体项必须提供对应的嵌套 URL 对象。支持公网 HTTP(S) 地址和已有的 asset:// 素材标识。

type	URL 字段	role
`image_url`	`image_url.url`	`first_frame`、`last_frame`、`reference_image`
`video_url`	`video_url.url`	`reference_video`
`audio_url`	`audio_url.url`	`reference_audio`

图片最多 9 张、视频最多 3 个、音频最多 3 个，简写与 typed content 一起计数。音频必须与图片或视频一起提供。2.0 不支持 `draft_task`。提示词请放在顶层 prompt，不要依赖 type: "text" 的 content 项。顶层 first_frame_url、last_frame_url、reference_image_urls、 reference_video_urls、reference_audio_urls 是指定角色的简写。 content 项中未列出的字段不会转发。

不支持 negativePrompt、seed、returnLastFrame、nsfwCheck、 tools、webhook、watermark、outputFormat 及其蛇形别名，这些参数会被拒绝。也不支持 width、height、fps、cfgScale、steps、style。

请求示例

文生视频

json

{
  "model": "seedance-2-0",
  "prompt": "清晨安静的城市街道，镜头缓慢向前移动",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}

首帧与尾帧

json

{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

参考图片与音频

json

{
  "model": "seedance-2.0",
  "prompt": "让画面随着节奏运动",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}

提交与查询结果

响应 data 包含 jobId、status、model、message。提交成功仅表示任务已受理。使用同一账户 API Key 查询 GET https://api.requestbeam.com/v1/jobs/{jobId}，详见查询异步任务。

COMPLETED 时读取 data.outputResult，其中每个 url 可能为字符串或数组。计费依据实际完成 token 和输出分辨率；有视频参考时使用视频输入费率，仅图片或音频参考不属于视频输入档。