Seedance 2.5 API 接口规范与调用
Seedance 2.5 API 快速调用
seedance-2.5Video generationPOST /v1/video/seedance
curl -X POST "https://api.requestbeam.com/v1/video/seedance" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.5","duration":5,"resolution":"720p","aspectRatio":"16:9","generateAudio":false,"prompt":"Use the supplied reference image to preserve the exact clear highball glass, orange citrus drink, ice, stone pedestal, lemon wedge and green leaf. Use the reference video only for its slow clockwise camera orbit and soft lighting rhythm. Create a fresh five-second premium beverage product shot in the same muted turquoise studio setting. Begin with the whole glass centered, make a small smooth clockwise orbit and finish slightly closer while retaining the entire glass. Keep the liquid level and glass shape consistent with the image; tiny bubbles rise naturally. One continuous shot, no cuts, no added objects, no text, no logos. Silent video, no music or speech.","metadata":{"content":[{"type":"image_url","role":"reference_image","image_url":{"url":"https://image.requestbeam.com/generated/364460494205222912/0.png"}},{"type":"video_url","role":"reference_video","video_url":{"url":"https://image.requestbeam.com/examples/seedance-2-0/2026-10-03/364460440891424768-text-to-video.mp4"}}]}}'家族与协议参考
Seedance 2.5 视频生成
完整 API 文档Seedance 2.5 多模态素材、音频生成与样片成片引用参数。
https://api.requestbeam.com/v1/video/seedance创建 Seedance 2.5 异步任务。Seedance 2.0 的参数见 独立文档。
鉴权
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json请求参数
modelstring必填seedance-2.5。
promptstring视频提示词，纯文本生成时必填；有图片或视频时可省略或留空。 引用 draft_task 时不要提供提示词。 metadata.content 中的 text 项会被丢弃，仅使用顶层 prompt。
durationnumber默认: 54 到 30 的整数，或 -1 自动时长。原生 seconds 接受对应的 整数字符串，也接受 metadata.duration。同时提供的时长别名必须一致。 引用 draft_task 时不要提供任何时长参数。
resolutionstring默认: 720p480p、720p、1080p。原生 size 可指定分辨率； metadata.resolution 优先。不支持 4k。
aspectRatiostring默认: 16:916: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。这些设置沿用样片。
- 可以指定输出分辨率。
即使原任务成功，兼容性或归属检查仍可能拒绝复用。 不要假设每个普通生成任务都能作为样片。
请求示例
多模态参考
{
"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"}
]
}
}首帧与尾帧
{
"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。 下面的占位符不是可使用的任务标识。
{
"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 可能为字符串或数组。