Amux AI

Create video

最近更新:2026年11月22日

使用 bytedance/seedance-2.5-flash 按火山方舟原生格式提交异步视频生成任务。

使用 bytedance/seedance-2.5-flash 提交异步视频生成任务。请求体采用火山方舟原生格式,文本提示词与输入素材统一放入 content[] 数组;现有火山方舟客户端只需更新 base_url 即可直接调用。

POSThttps://gateway.amux.ai/api/v3/contents/generations/tasks

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> API 密钥(Bearer Token)。

请求

application/json
modelstring必填

模型标识,填写 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 字段指定。

textstring

type 为 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_urlobject

type 为 image_url 时的图片地址对象,需为公网可访问的 HTTPS 地址。

›image_urlobject
urlstring

公网可访问的 HTTPS 图片地址。

video_urlobject

type 为 video_url 时的参考视频地址对象(mp4 / mov,单段 2–30 秒,总时长 ≤ 30 秒)。

›video_urlobject
urlstring

公网可访问的 HTTPS 视频地址。

audio_urlobject

type 为 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 协议迁移时需注意)。

参数取值范围

参数取值说明
resolution480p / 720p(不支持 1080p 与 4k)
duration-1 或 4–30 的整数
ratio / aspect_ratioadaptive 或 6 种固定宽高比(⚠️ 首帧、视频编辑、视频延长场景仅支持 adaptive)
素材上限首帧 1、尾帧 1、参考图 10、参考视频 5 段、参考音频 5 段(视频与音频单段 2–30 秒,各自总时长 ≤ 30 秒)
仅传参考音频支持
output_formatmp4 / mov(⚠️ 当前暂不支持切换封装格式,输出固定为 mp4)
omni_reference_task_typeauto / 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
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>"
}