Seedance 2.0 API 接口规范与调用
Seedance 2.0 API 快速调用
seedance-2.0Video 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.0","duration":5,"resolution":"720p","aspectRatio":"16:9","generateAudio":false,"prompt":"Premium beverage product film, one continuous five-second shot. A single tall clear glass filled with sparkling orange citrus drink and clear ice cubes stands on a pale gray stone pedestal, a small lemon wedge on the left and one green leaf on the right, clean muted turquoise studio background. Soft daylight from upper left glints through the glass. The camera makes a slow, subtle clockwise orbit while keeping the entire glass centered. Tiny bubbles rise naturally and condensation glistens. Preserve the glass shape and orange drink color throughout. No cuts, no hands, no text, no logos, no music, no speech. Silent video.","metadata":{"content":[{"type":"image_url","role":"first_frame","image_url":{"url":"https://image.requestbeam.com/generated/364459846248173568/0.png"}}]}}'家族与协议参考
Seedance 2.0 视频生成
完整 API 文档Seedance 2.0 文生视频、首尾帧、多模态参考和音频生成参数。
https://api.requestbeam.com/v1/video/seedance创建 Seedance 2.0 异步任务。Seedance 2.5 的参数见 独立文档。
鉴权
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:916: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。
请求示例
文生视频
{
"model": "seedance-2-0",
"prompt": "清晨安静的城市街道，镜头缓慢向前移动",
"seconds": "5",
"size": "720p",
"metadata": {"ratio": "16:9", "generate_audio": true}
}首帧与尾帧
{
"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"}
]
}
}参考图片与音频
{
"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 和输出分辨率；有视频参考时使用视频输入费率， 仅图片或音频参考不属于视频输入档。