Create task
最近更新:2026年11月22日
通过统一异步任务入口提交 bytedance/seedance-2.5-flash 视频生成任务。
通过统一异步任务入口 /v1/tasks 提交 bytedance/seedance-2.5-flash 视频生成任务,文本提示词、输入素材与生成参数均平铺在顶层。
https://gateway.amux.ai/v1/tasks鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> API 密钥(Bearer Token)。
请求
application/jsonmodelstring必填模型标识,填写 bytedance/seedance-2.5-flash(兼容 seedance-2.5-flash、doubao-seedance-2-5-flash、dreamina-seedance-2-5-flash,大小写不敏感)。
promptstring文本提示词。可选项,仅传入 media 时亦可提交任务。
mediaarray<object>输入素材列表,通过 type 指定素材用途(对应原生接口的 role)。需为公网可访问的 HTTPS 地址。
›mediaarray<object>
type"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"必填素材用途。单次请求上限:首帧 1 张、尾帧 1 张、参考图 10 张、参考视频 5 段、参考音频 5 段(参考视频与音频单段 2–30 秒,各自总时长 ≤ 30 秒)。支持仅传参考音频。
⚠️ 首尾帧(first_frame / last_frame)与参考素材互斥,不可混用。
urlstring必填公网可访问的 HTTPS 素材地址。
resolution"480p" | "720p"默认 "720p"输出分辨率档位,仅支持 480p 与 720p(不支持 1080p 与 4k)。两档适用相同 token 单价,分辨率越高输出 token 用量越大。
durationinteger默认 -1输出视频时长(秒),支持 -1(由模型在有效区间内自动决定)或 4–30 的整数。时长直接决定输出视频 token 用量。
aspect_ratio"adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"默认 "adaptive"输出画面宽高比,adaptive 表示根据输入素材或提示词自适应。
⚠️ 传入首帧,或执行视频编辑 / 视频延长子任务时,仅支持 adaptive(显式传入固定比例将返回 400)。
generate_audioboolean默认 true是否生成同步音频(含人声、音效与背景音乐)。默认开启;如需无声视频请显式传入 false。
watermarkboolean默认 false是否在输出视频右下角添加水印。
return_last_frameboolean默认 false是否额外返回输出视频尾帧 JPEG 图像(分辨率与输出视频一致,水印状态跟随 watermark)。⚠️ 当前暂不支持该参数,设置后不生效。
output_format"mp4" | "mov"默认 "mp4"输出视频封装格式。mov 采用 H.264 + yuv444p + PCM 编码,适用于后期调色、抠像与合成。⚠️ 当前暂不支持切换封装格式,输出固定为 mp4。
omni_reference_task_type"auto" | "reference" | "edit" | "extend"默认 "auto"全模态参考子任务类型。默认 auto 由模型自动判定;显式指定 edit 或 extend 可在提交阶段同步校验参数约束。
⚠️ edit 与 extend 均要求至少包含 1 段参考视频且 aspect_ratio 为 adaptive;edit 同时要求 duration 为 -1(参考视频时长需为 4–30 秒)。
web_searchboolean默认 false是否启用联网搜索(对应火山方舟原生接口的 tools: [{ type: "web_search" }])。
priorityinteger默认 0队列调度优先级(0–9),数值越大越优先调度,仅影响排队顺序,不会中断运行中的任务。
execution_expires_afterinteger默认 172800任务超时阈值(秒),自创建时间起计算,默认 172800(48 小时)。超时未完成的任务将终止并置为 expired。
userstring终端用户唯一标识(对应原生接口的 safety_identifier,建议传入哈希值)。
webhook_urlstring任务到达终态时的公网 HTTPS 回调通知地址(对应原生接口的 callback_url)。
响应
200response任务已受理,可通过 GET /v1/tasks/{id} 轮询状态。
400response请求参数越界、素材组合冲突或包含不支持的 Seedance 1.x 参数。
402response账户可用余额不足以覆盖任务预扣额度上限。
503response服务暂不可用。
与火山方舟原生格式的对应关系
两条入口的计费与预扣规则完全一致,仅请求与响应结构不同:
| 项目 | 火山方舟原生格式 | 统一接口格式 |
|---|---|---|
| 提示词与素材 | content[] 数组 | prompt + media[] |
| 素材用途字段 | role | media[].type |
| 素材地址结构 | 嵌套 <type>.url | 平铺 media[].url |
| 宽高比参数 | ratio | aspect_ratio |
| 联网搜索 | tools: [{ type: "web_search" }] | 布尔 web_search |
| 终端用户标识 | safety_identifier | user |
| 终态回调地址 | callback_url | webhook_url |
查询返回费用 cost | 无 | 有 |
参数取值范围
| 参数 | 取值说明 |
|---|---|
resolution | 480p / 720p(不支持 1080p 与 4k) |
duration | -1 或 4–30 的整数 |
aspect_ratio | adaptive 或 6 种固定宽高比(⚠️ 首帧、视频编辑、视频延长场景仅支持 adaptive) |
| 素材上限 | 首帧 1、尾帧 1、参考图 10、参考视频 5 段、参考音频 5 段(视频与音频单段 2–30 秒,各自总时长 ≤ 30 秒) |
| 仅传参考音频 | 支持 |
output_format | mp4 / mov(⚠️ 当前暂不支持切换封装格式,输出固定为 mp4) |
omni_reference_task_type | auto / reference / edit / extend |
prompt 为可选项,仅传入 media 时亦可提交任务。
计费说明
结算依据为 usage.output_video_tokens,cost 按该用量乘对应档位单价计算。参考图与参考音频不计费;包含参考视频输入的请求整单适用更低的 token 单价。
查询任务结果
提交成功后立即返回任务 id,请调用统一查询接口异步轮询状态,或配置 webhook_url 接收终态回调通知。
curl https://gateway.amux.ai/v1/tasks \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "bytedance/seedance-2.5-flash",
"prompt": "A ginger cat running through fresh snow, slow motion",
"resolution": "720p",
"duration": -1
}'{
"id": "task_01M1VD9E8WRYVBR7ES10SNQQQT",
"status": "queued",
"model": "bytedance/seedance-2.5-flash",
"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.54",
"notes": [
"<string>"
],
"error": {
"message": "<string>",
"code": "<string>"
}
}