Create task
最近更新：2026年9月8日
用站内统一入口提交 bytedance/doubao-seedance-2-0-fast 的异步任务，请求体是平铺的。
用站内统一入口提交 bytedance/doubao-seedance-2-0-fast 的视频任务。请求体是平铺的：提示词、素材与参数
都在顶层。
https://gateway.amux.ai/v1/tasks鉴权
headerAuthorizationstring必填Bearer <你的 Amux 密钥> 站内 API Key。
请求
application/jsonmodelstring必填固定为 bytedance/doubao-seedance-2-0-fast。也可以用不带厂商前缀的 doubao-seedance-2-0-fast，大小写不敏感。
promptstring生成内容的描述。可选——只给 media 也能出片。
mediaarray<object>输入素材，每一件用 type 标明用途（厂商形状里那个字段叫 role）。
只收公开可访问的 https 地址。
›mediaarray<object>
type"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"必填这件素材的用途。上限：首帧 1 张、尾帧 1 张、参考图 9 张、参考视频 3 段、参考音频 3 段（视频与音频各自单段 2–15 秒、合计不超过 15 秒）。
⚠️ 不能只传参考音频——至少要有一段参考视频或一张图。
⚠️ 首尾帧与参考素材互斥——官方把首帧、首尾帧、全模态参考定义成三种场景，混用会被拒。
urlstring必填公开可访问的 https 地址。由模型自己去取，本站不代取。
resolution"480p" | "720p"默认 "720p"输出分辨率档。这个模型有 480p / 720p。
档位越高越贵，多数是因为它产出的 token 更多，而不是因为单价不同——例外是 1080p 与 4k，那两档还各自换了一档 token 单价。
durationinteger默认 -1出片时长（秒）：-1 或 4–15 的整数。-1 表示由模型在这个区间里自己定。
⚠️ 时长直接决定 token 数，也就直接决定这次花多少钱。
aspect_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 尾帧（无水印，尺寸同视频）。拿它当下一段的首帧，
就能接出连续的多段视频。
web_searchboolean默认 false联网搜索。开启后模型自主判断要不要搜互联网内容（商品、天气这类），
时效性更好但会增加时延。
⚠️ 厂商形状那条把它写成 tools: [{ type: "web_search" }]——
同一个能力，两种线格式。
priorityinteger默认 0排队优先级，越大越靠前。只影响同一个接入点内的排队顺序，不会打断
已经在跑的任务。
execution_expires_afterinteger默认 172800任务超时阈值（秒），从创建时刻算起，默认 48 小时。超过之后任务被
终止并落 expired。
userstring终端用户的唯一标识，用于风控归因。传哈希值，不要传明文用户名或邮箱。
webhook_urlstring任务到终态时回调这个地址。厂商形状那条把它叫作 callback_url——同一件事，
两个名字。必须是可投递的公网 https 地址。
响应
200response任务已受理。拿 id 去 GET /v1/tasks/{id} 轮询。
400response参数不合法、素材组合不成立，或传了这一代不支持的 1.x 参数。
402response可用余额不足以覆盖预扣上界。
503response当前没有可用的供应商能服务这个模型。
和原生形状的关系
计费、路由、预扣完全一致，只有线格式不同：
| 原生形状 | 这一条 | |
|---|---|---|
| 提示词与素材 | 同一个 content[] 数组 | prompt + media[] 两个字段 |
| 素材用途 | role | media[].type |
| 素材地址 | 嵌套 image_url.url | 平铺 media[].url |
| 比例参数名 | ratio | aspect_ratio |
| 联网搜索 | tools: [{ type: "web_search" }] | 布尔 web_search |
| 终端用户标识 | safety_identifier | user |
| 取回时有用量与费用 | 没有 | 有 |
取值域
| 参数 | 这个模型 |
|---|---|
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 | 没有这个参数 |
🟢 prompt 可选——只给 media 也能出片，这一条和 MiniMax 那条相反。
计费：按 token
usage.output_video_tokens 是结算依据，cost 就是拿它乘单价算出来的。
参考图与参考音频免费；带参考视频的请求整单换一档更低的单价。
提交返回任务 ID
拿 id 去取回口轮询。
一段视频跑十几分钟很正常，不要把它挂在一条 HTTP 连接上等。
curl https://gateway.amux.ai/v1/tasks \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "bytedance/doubao-seedance-2-0-fast",
"prompt": "A ginger cat running through fresh snow, slow motion",
"resolution": "720p",
"duration": -1
}'{
"id": "task_01M1VD9E8WRYVBR7ES10SNQQQT",
"status": "queued",
"model": "bytedance/doubao-seedance-2-0-fast",
"created_at": "<string>",
"output": {
"images": [
{}
],
"videos": [
{
"index": 0,
"url": "<string>"
}
]
},
"usage": {
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0,
"output_video_tokens": 0
},
"cost": "0.83",
"notes": [
"<string>"
],
"error": {
"message": "<string>",
"code": "<string>"
}
}