Seedance 2.5 视频生成 | API 文档

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

鉴权

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

modelstring必填

seedance-2.5。

promptstring

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

durationnumber默认: 5

4 到 30 的整数，或 -1 自动时长。原生 seconds 接受对应的整数字符串，也接受 metadata.duration。同时提供的时长别名必须一致。引用 draft_task 时不要提供任何时长参数。

resolutionstring默认: 720p

480p、720p、1080p。原生 size 可指定分辨率； metadata.resolution 优先。不支持 4k。

aspectRatiostring默认: 16:9

16:9、9:16、1:1、4:3、3:4、21:9、adaptive。接受 aspect_ratio、ratio 和 metadata.ratio。为兼容旧请求，size 中的宽高比值仍然可用，但分辨率值表示分辨率。首尾帧输入要求 adaptive；有首尾帧角色但未显式指定比例时自动选用。

metadataobject

接受 resolution、ratio、duration、content、generate_audio、 output_format。generate_audio 是音频生成布尔开关。顶层 generateAudio / generate_audio 是别名，请仅提供一个音频控制项。

imageUrlsstring[]

参考图片，支持 images、imageUrl、image_urls、image_url 别名。原生 images 简写的前两张分别用作首尾帧；imageUrls 保持参考图片语义。

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 别名。同一请求必须有图片或视频素材。

outputFormatstring默认: mp4

仅支持 mp4，接受 output_format、metadata.output_format。不支持 mov 和 watermark。

callback_urlstring

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

多模态素材

媒体 URL 支持公网 HTTP(S) 地址和已有的 asset:// 素材标识。

type	嵌套字段	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`
`draft_task`	`draft_task.id`	无 role，仅用于样片引用

图片最多 30 张、视频最多 10 个、音频最多 10 个，素材合计不超过 50 个，简写与 typed content 一起计数。音频必须与图片或视频一起提供。提示词请使用顶层 prompt，不要依赖 type: "text" content。同一设置请仅使用一种别名。不支持的控制项会被拒绝。顶层 first_frame_url、last_frame_url、reference_image_urls、 reference_video_urls、reference_audio_urls 是指定角色的简写。 content 项中未列出的字段不会转发。

样片成片引用

`draft_task` 仅限 Seedance 2.5，用于复用已有的兼容已完成样片。本页不定义样片创建参数。

metadata.content 只能包含一个 draft_task 项。
draft_task.id 优先使用已有样片返回的 Synapse 十进制字符串 jobId。

也接受已记录的平台 task_... 标识；不要传上游原始任务 ID 或虚构标识。

样片必须属于同一账户、使用相同模型和处理通道，已完成且创建时间距今不足 7 天。
不要再传提示词、图片/视频/音频、时长、宽高比、seed、generate_audio、

输出格式、omni_reference_task_type。这些设置沿用样片。

可以指定输出分辨率。

即使原任务成功，兼容性或归属检查仍可能拒绝复用。不要假设每个普通生成任务都能作为样片。

请求示例

多模态参考

json

{
  "model": "seedance-2.5",
  "prompt": "保持参考人物和运镜风格，生成连贯的短片",
  "seconds": "8",
  "size": "720p",
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/camera.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ]
  }
}

首帧与尾帧

json

{
  "model": "seedance-2.5",
  "duration": 5,
  "metadata": {
    "ratio": "adaptive",
    "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"}
    ]
  }
}

引用已有样片

将 EXISTING_SAMPLE_JOB_ID 替换为真实兼容已完成样片返回的 jobId。下面的占位符不是可使用的任务标识。

json

{
  "model": "seedance-2.5",
  "metadata": {
    "resolution": "1080p",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "EXISTING_SAMPLE_JOB_ID"}}
    ]
  }
}

提交与查询结果

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

COMPLETED 时读取 data.outputResult，其中每个 url 可能为字符串或数组。