Amux AI

Create task

最近更新:2026年11月22日

通过统一异步任务入口提交 bytedance/seedance-2.5-flash 视频生成任务。

通过统一异步任务入口 /v1/tasks 提交 bytedance/seedance-2.5-flash 视频生成任务,文本提示词、输入素材与生成参数均平铺在顶层。

POSThttps://gateway.amux.ai/v1/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,大小写不敏感)。

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[]
素材用途字段rolemedia[].type
素材地址结构嵌套 <type>.url平铺 media[].url
宽高比参数ratioaspect_ratio
联网搜索tools: [{ type: "web_search" }]布尔 web_search
终端用户标识safety_identifieruser
终态回调地址callback_urlwebhook_url
查询返回费用 cost无有

参数取值范围

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

prompt 为可选项,仅传入 media 时亦可提交任务。

计费说明

结算依据为 usage.output_video_tokens,cost 按该用量乘对应档位单价计算。参考图与参考音频不计费;包含参考视频输入的请求整单适用更低的 token 单价。

查询任务结果

提交成功后立即返回任务 id,请调用统一查询接口异步轮询状态,或配置 webhook_url 接收终态回调通知。

cURL
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>"
  }
}