Amux AI

Create video

最近更新:2026年9月8日

用 bytedance/seedance-2.0 出片,走火山方舟原生形状,现有方舟客户端直接可用。

用 bytedance/seedance-2.0 出片,走火山方舟原生形状:提示词与素材放在同一个 content[] 数组里。已有方舟代码时,把 base_url 指向本站即可。

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 站内 API Key。

请求

application/json
modelstring必填

固定为 bytedance/seedance-2.0。也可以用不带厂商前缀的 doubao-seedance-2-0,大小写不敏感。

contentarray<object>必填

提示词与输入素材放在同一个数组里。

🟢 text 项不是必填——只给一张首帧、或者只给参考素材,都是合法请求。

必须成立的只有「数组不为空」。这一条和 MiniMax 那种形状相反。

›contentarray<object>
type"text" | "image_url" | "video_url" | "audio_url"必填

这一项是什么种类。⚠️ 它不是用途——用途在 role 上。

textstring

type: text 时的提示词。指代素材时用自然语言描述(「参考图1里的人物」),

这个模型没有 [Image 1] 那类标记。

role"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"

这件素材的用途。上限:首帧 1 张、尾帧 1 张、参考图 9 张、参考视频 3 段、参考音频 3 段(视频与音频各自单段 2–15 秒、合计不超过 15 秒)。

⚠️ 不能只传参考音频——至少要有一段参考视频或一张图。

⚠️ 首尾帧与参考素材互斥——官方把首帧、首尾帧、全模态参考定义成三种场景,混用会被拒。

image_urlobject

⚠️ 地址嵌在与 type 同名的对象里(image_url / video_url / audio_url),

不是平铺的 url。只收公开可访问的 https 地址。

›image_urlobject
urlstring

公开可访问的 https 地址。由模型自己去取,本站不代取。

resolution"480p" | "720p" | "1080p" | "4k"默认 "720p"

输出分辨率档。这个模型有 480p / 720p / 1080p / 4k。

档位越高越贵,多数是因为它产出的 token 更多,而不是因为单价不同——例外是 1080p 与 4k,那两档还各自换了一档 token 单价。

⚠️ 这两档的产物是 10bit 位深 + H.265/HEVC 编码,少数播放器打不开。

durationinteger默认 -1

出片时长(秒):-1 或 4–15 的整数。-1 表示由模型在这个区间里自己定。

⚠️ 时长直接决定 token 数,也就直接决定这次花多少钱。

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 尾帧(无水印,尺寸同视频)。拿它当下一段的首帧,

就能接出连续的多段视频。

toolsarray<object>

工具配置,目前只有联网搜索。开启后模型自主判断要不要搜互联网内容

(商品、天气这类),时效性更好但会增加时延。

›toolsarray<object>
type"web_search"必填

固定为 web_search。目前只有联网搜索这一种工具。

priorityinteger默认 0

排队优先级,越大越靠前。只影响同一个接入点内的排队顺序,不会打断

已经在跑的任务。

execution_expires_afterinteger默认 172800

任务超时阈值(秒),从创建时刻算起,默认 48 小时。超过之后任务被

终止并落 expired。

safety_identifierstring

终端用户的唯一标识,用于风控归因。传哈希值,不要传明文用户名或邮箱。

callback_urlstring

任务到终态时回调这个地址。它就是站内的 webhook_url——我们只是按厂商的

字段名收下;投递内容与统一入口那条完全一致。必须是可投递的公网 https 地址。

响应

200response

任务已受理。响应体里只有 id,和官方一致。

400response

参数不合法、素材组合不成立,或传了这一代不支持的 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用途:首帧、尾帧、参考图 / 参考视频 / 参考音频
<type>.url地址,嵌在一个与 type 同名的对象里

role 可以省略的只有三种情况,与火山官方一致:整个 content 里只有一张图片时视为首帧(first_frame);video_url 视为 reference_video;audio_url 视为 reference_audio。 首尾帧和参考图的 role 必须写——图片和别的素材一起给又没写 role 时返回 400,不会替你猜。

3. 首帧、首尾帧与参考素材互斥

首帧、首尾帧、全模态参考是三种互斥的场景,混用将被上游拒绝。 从 MiniMax 迁移时需特别注意:该协议允许首尾帧与参考素材同时传入。

取值域

参数这个模型
resolution480p / 720p / 1080p / 4k
duration-1 或 4–15 的整数
ratio / aspect_ratioadaptive / 六个具体比例,首帧场景也可以指定
素材上限首帧 1、尾帧 1、参考图 9、参考视频 3 段、参考音频 3 段(视频与音频单段 2–15 秒、合计 ≤ 15 秒)
只传音频不行,至少要有一段参考视频或一张图
output_format没有这个参数
omni_reference_task_type没有这个参数

🟢 这个模型的首帧场景可以指定具体比例——「只收 adaptive」那条限制 仅 Seedance 2.5 支持,请勿参照该模型的文档配置。

Seedance 1.x 的参数会报错

seed、camera_fixed、frames、draft、service_tier=flex 这几个在 1.x 上有效, Seedance 2.x 均不支持。传入后将在提交时返回错误,而非静默忽略: 静默忽略会使调用方误以为参数已生效,却得到与预期不符的结果。

计费:按 token

站内其它视频模型按出片秒数计费,Seedance 不是:

tokens = 宽 × 高 × 帧数 / 1024      帧数 = 秒数 × 24 + 1

因此分辨率与时长越高,费用通常越高,主要来自 token 数量的增长。 参考图与参考音频免费;参考视频的成本已包含在该 token 数中,不单独计费, 且输入含参考视频的请求整单适用更低的 token 单价。

⚠️ 1080p 与 4k 另有独立单价,且方向并不一致:1080p 高于 480p / 720p 档,而 4k 低于其余各档。该档 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.0",
    "content": [
      {
        "type": "text",
        "text": "A ginger cat running through fresh snow, slow motion"
      }
    ],
    "resolution": "720p",
    "duration": -1
  }'
{
  "id": "<string>"
}