Create video
最近更新：2026年9月8日
用 bytedance/doubao-seedance-2-0-fast 出片，走火山方舟原生形状，现有方舟客户端直接可用。
用 bytedance/doubao-seedance-2-0-fast 出片，走火山方舟原生形状：提示词与素材放在同一个
content[] 数组里。已有方舟代码时，把 base_url 指向本站即可。
https://gateway.amux.ai/api/v3/contents/generations/tasks鉴权
headerAuthorizationstring必填Bearer <你的 Amux 密钥> 站内 API Key。
请求
application/jsonmodelstring必填固定为 bytedance/doubao-seedance-2-0-fast。也可以用不带厂商前缀的 doubao-seedance-2-0-fast，大小写不敏感。
contentarray<object>必填提示词与输入素材放在同一个数组里。
🟢 text 项不是必填——只给一张首帧、或者只给参考素材，都是合法请求。
必须成立的只有「数组不为空」。这一条和 MiniMax 那种形状相反。
›contentarray<object>
type"text" | "image_url" | "video_url" | "audio_url"必填这一项是什么种类。⚠️ 它不是用途——用途在 role 上。
textstringtype: text 时的提示词。指代素材时用自然语言描述（「参考图1里的人物」），
这个模型没有 [Image 1] 那类标记。
role"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"这件素材的用途。上限：首帧 1 张、尾帧 1 张、参考图 9 张、参考视频 3 段、参考音频 3 段（视频与音频各自单段 2–15 秒、合计不超过 15 秒）。
⚠️ 不能只传参考音频——至少要有一段参考视频或一张图。
⚠️ 首尾帧与参考素材互斥——官方把首帧、首尾帧、全模态参考定义成三种场景，混用会被拒。
image_urlobject⚠️ 地址嵌在与 type 同名的对象里（image_url / video_url / audio_url），
不是平铺的 url。只收公开可访问的 https 地址。
›image_urlobject
urlstring公开可访问的 https 地址。由模型自己去取，本站不代取。
resolution"480p" | "720p"默认 "720p"输出分辨率档。这个模型有 480p / 720p。
档位越高越贵，多数是因为它产出的 token 更多，而不是因为单价不同——例外是 1080p 与 4k，那两档还各自换了一档 token 单价。
durationinteger默认 -1出片时长（秒）：-1 或 4–15 的整数。-1 表示由模型在这个区间里自己定。
⚠️ 时长直接决定 token 数，也就直接决定这次花多少钱。
ratio"adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"默认 "adaptive"画面比例。adaptive 跟着输入素材走。
这个模型可以指定具体比例，首帧场景也不例外——那条限制只属于 Seedance 2.5。
generate_audioboolean默认 true出片带不带声音。默认开——模型按提示词与画面自动配上人声、音效与
背景音乐。要无声视频就显式传 false。
watermarkboolean默认 false是否在右下角打「AI 生成」水印。
return_last_frameboolean默认 false是否额外返回一张 png 尾帧（无水印，尺寸同视频）。拿它当下一段的首帧，
就能接出连续的多段视频。
toolsarray<object>工具配置，目前只有联网搜索。开启后模型自主判断要不要搜互联网内容
（商品、天气这类），时效性更好但会增加时延。
›toolsarray<object>
type"web_search"必填固定为 web_search。目前只有联网搜索这一种工具。
priorityinteger默认 0排队优先级，越大越靠前。只影响同一个接入点内的排队顺序，不会打断
已经在跑的任务。
execution_expires_afterinteger默认 172800任务超时阈值（秒），从创建时刻算起，默认 48 小时。超过之后任务被
终止并落 expired。
safety_identifierstring终端用户的唯一标识，用于风控归因。传哈希值，不要传明文用户名或邮箱。
callback_urlstring任务到终态时回调这个地址。它就是站内的 webhook_url——我们只是按厂商的
字段名收下；投递内容与统一入口那条完全一致。必须是可投递的公网 https 地址。
响应
200response任务已受理。响应体里只有 id，和官方一致。
400response参数不合法、素材组合不成立，或传了这一代不支持的 1.x 参数。
402response可用余额不足以覆盖预扣上界。
503response当前没有可用的供应商能服务这个模型。
三处最容易踩的
1. 提示词是可选的
content 里可以一条 text 都没有——纯首帧、纯首尾帧、只给参考图或参考视频都是官方支持的组合。
必须成立的只有「数组不为空」。这一条和 MiniMax 那种形状相反，那边的提示词恒必填。
2. type 不是用途，地址也不是平铺的
{
"content": [
{ "type": "text", "text": "让画面里的人走向镜头" },
{ "type": "image_url", "role": "first_frame", "image_url": { "url": "https://…/a.png" } }
]
}| 字段 | 是什么 |
|---|---|
type | 媒体种类：text / image_url / video_url / audio_url |
role | 用途：首帧、尾帧、参考图 / 参考视频 / 参考音频 |
<type>.url | 地址，嵌在一个与 type 同名的对象里 |
role 不能省——省了返回 400，不会被猜成首帧。
3. 三种场景互斥
首帧、首尾帧、全模态参考是三种互斥的场景，混用会被上游拒。 从 MiniMax 迁过来时最容易撞上这一条，那边可以把首尾帧和参考素材一起给。
取值域
| 参数 | 这个模型 |
|---|---|
resolution | 480p / 720p |
duration | -1 或 4–15 的整数 |
ratio / aspect_ratio | adaptive / 六个具体比例，首帧场景也可以指定 |
| 素材上限 | 首帧 1、尾帧 1、参考图 9、参考视频 3 段、参考音频 3 段（视频与音频单段 2–15 秒、合计 ≤ 15 秒） |
| 只传音频 | 不行，至少要有一段参考视频或一张图 |
output_format | 没有这个参数 |
omni_reference_task_type | 没有这个参数 |
🟢 这个模型的首帧场景可以指定具体比例——「只收 adaptive」那条限制
只属于 Seedance 2.5，别照着它的文档写。
Seedance 1.x 的参数会报错
seed、camera_fixed、frames、draft、service_tier=flex 这几个在 1.x 上有效，
Seedance 2.x 一个都不支持。传了会在提交时被拒，而不是被静默丢掉——
静默丢掉的表现是你以为 seed 生效了、拿回一个随机结果。
计费：按 token
站内其它视频模型按出片秒数计费，Seedance 不是：
tokens = 宽 × 高 × 帧数 / 1024 帧数 = 秒数 × 24 fps
所以分辨率与时长越高越贵，多数是因为它产出的 token 更多。 参考图与参考音频免费；参考视频的成本已经含在这个 token 数里，不单独计费， 而且带参考视频的请求整单换一档更低的单价。
取回时 usage.output_video_tokens 就是结算依据（统一形状那条）。
curl https://gateway.amux.ai/api/v3/contents/generations/tasks \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "bytedance/doubao-seedance-2-0-fast",
"content": [
{
"type": "text",
"text": "A ginger cat running through fresh snow, slow motion"
}
],
"resolution": "720p",
"duration": -1
}'{
"id": "<string>"
}