Create video
最近更新:2026年11月22日
使用 bytedance/seedance-2.5-flash 按火山方舟原生格式提交异步视频生成任务。
使用 bytedance/seedance-2.5-flash 提交异步视频生成任务。请求体采用火山方舟原生格式,文本提示词与输入素材统一放入 content[] 数组;现有火山方舟客户端只需更新 base_url 即可直接调用。
https://gateway.amux.ai/api/v3/contents/generations/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,大小写不敏感)。
contentarray<object>必填文本提示词与输入素材列表,数组不可为空。text 条目为可选项,支持仅传入首帧、首尾帧或参考素材(含纯参考音频)。
›contentarray<object>
type"text" | "image_url" | "video_url" | "audio_url"必填内容条目类型。媒体素材的具体用途通过 role 字段指定。
textstringtype 为 text 时的文本提示词。建议使用自然语言指代输入素材(如“参考图 1 中的人物”)。
role"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"素材用途。单次请求上限:首帧 1 张、尾帧 1 张、参考图 10 张、参考视频 5 段、参考音频 5 段(参考视频与音频单段 2–30 秒,各自总时长 ≤ 30 秒)。支持仅传参考音频。
⚠️ 首尾帧(first_frame / last_frame)与参考素材互斥,不可混用;缺失必填 role 时返回 400。
image_urlobjecttype 为 image_url 时的图片地址对象,需为公网可访问的 HTTPS 地址。
›image_urlobject
urlstring公网可访问的 HTTPS 图片地址。
video_urlobjecttype 为 video_url 时的参考视频地址对象(mp4 / mov,单段 2–30 秒,总时长 ≤ 30 秒)。
›video_urlobject
urlstring公网可访问的 HTTPS 视频地址。
audio_urlobjecttype 为 audio_url 时的参考音频地址对象(wav / mp3,单段 2–30 秒,总时长 ≤ 30 秒)。
›audio_urlobject
urlstring公网可访问的 HTTPS 音频地址。
resolution"480p" | "720p"默认 "720p"输出分辨率档位,仅支持 480p 与 720p(不支持 1080p 与 4k)。两档适用相同 token 单价,分辨率越高输出 token 用量越大。
durationinteger默认 -1输出视频时长(秒),支持 -1(由模型在有效区间内自动决定)或 4–30 的整数。时长直接决定输出视频 token 用量。
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 段参考视频且 ratio 为 adaptive;edit 同时要求 duration 为 -1(参考视频时长需为 4–30 秒)。
toolsarray<object>工具配置列表,当前仅支持 web_search(联网搜索)。开启后由模型自主判断是否检索实时网页信息。
›toolsarray<object>
type"web_search"必填工具类型,固定为 web_search。
priorityinteger默认 0队列调度优先级(0–9),数值越大越优先调度,仅影响排队顺序,不会中断运行中的任务。
execution_expires_afterinteger默认 172800任务超时阈值(秒),自创建时间起计算,默认 172800(48 小时)。超时未完成的任务将终止并置为 expired。
safety_identifierstring终端用户唯一标识,用于安全审计(建议传入哈希值,请勿传入明文个人信息)。
callback_urlstring任务到达终态时的公网 HTTPS 回调通知地址,投递载荷与统一接口的 webhook_url 一致。
响应
200response任务已受理,返回任务 id。
400response请求参数越界、素材组合冲突或包含不支持的 Seedance 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 | 素材用途:first_frame / last_frame / reference_image / reference_video / reference_audio |
<type>.url | 公网可访问的 HTTPS 素材地址,嵌套在与 type 同名的对象内 |
role 仅在以下三种情形可省略:整个 content 仅含单张图片时默认视为 first_frame;video_url 默认视为 reference_video;audio_url 默认视为 reference_audio。其余组合传入图片时必须显式指定 role,缺失时返回 400。
3. 首帧、首尾帧与参考素材互斥
首帧图生视频、首尾帧过渡与多模态参考属于三种互斥生成模式,混用将在提交阶段返回 400(从支持首尾帧与参考素材混用的 MiniMax 协议迁移时需注意)。
参数取值范围
| 参数 | 取值说明 |
|---|---|
resolution | 480p / 720p(不支持 1080p 与 4k) |
duration | -1 或 4–30 的整数 |
ratio / 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 |
⚠️ 传入首帧时 ratio 仅支持 adaptive:输出宽高比跟随首帧图片,显式传入固定比例将在提交阶段返回 400。
全模态参考子任务
当 content 包含 reference_image、reference_video 或 reference_audio 时,模型依据提示词意图自动归类为以下三种子任务之一:
| 子任务 | 触发条件 | 强制约束 |
|---|---|---|
参考生成 reference | 提示词未表达编辑或延长意图 | 无额外约束 |
视频编辑 edit | 包含参考视频且表达编辑意图(新增、删除、替换、修改等) | ratio 必须为 adaptive;duration 必须为 -1;参考视频时长需为 4–30 秒 |
视频延长 extend | 包含参考视频且表达延长意图(续写、向前或向后延长等) | ratio 必须为 adaptive |
校验时机与 omni_reference_task_type
| 取值 | 校验时机 | 违背约束时的行为 |
|---|---|---|
edit / extend(显式指定) | 提交阶段同步校验 | 立即返回 400 |
auto 或省略 | 任务执行阶段异步校验 | 任务置为 failed(错误码 InvalidParameter.TaskTypeConstraint) |
显式指定子任务类型可将参数校验提前至提交阶段;但若模型根据提示词判定的实际意图与显式指定值不一致,任务仍将在运行阶段失败(InvalidParameter.TaskTypeMismatch)。不确定子任务类型时,建议配置 omni_reference_task_type: "auto" 搭配 ratio: "adaptive" 与 duration: -1,可同时满足全部子任务约束。
不支持的参数
Seedance 1.x 系列参数(seed、camera_fixed、frames、service_tier=flex)及 draft 样片模式均不支持。传入上述参数将在提交阶段直接返回 400 错误,不会静默忽略。
计费说明
该模型按输出视频 token 用量计费,换算公式为:
tokens = 宽 × 高 × 帧数 / 1024 帧数 = 秒数 × 24 + 1
480p 与 720p 适用相同 token 单价,分辨率与时长越高产出的视频 token 用量越大。参考图与参考音频不计费;参考视频成本已计入总 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/seedance-2.5-flash",
"content": [
{
"type": "text",
"text": "A ginger cat running through fresh snow, slow motion"
}
],
"resolution": "720p",
"duration": -1
}'{
"id": "<string>"
}