Amux

Create task

最近更新：2026年9月7日

用 minimax/minimax-h3-max 提交异步任务，走站内统一入口。请求体平铺。

用站内统一入口提交 minimax/minimax-h3-max 的视频任务。请求体是平铺的：提示词、素材与参数 都在顶层。

POSThttps://gateway.amux.ai/v1/tasks

鉴权

header
Authorizationstring必填

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

请求

application/json
modelstring必填

固定为 minimax/minimax-h3-max。也可以用不带厂商前缀的 minimax-h3-max，大小写不敏感。

promptstring必填

生成内容的描述。必填，最长 7000 字符。

mediaarray<object>

输入素材，每一件通过 type 标明用途。这个模型收的是：first_frame / last_frame。 仅接受公开可访问的 https 地址。

›mediaarray<object>
type"first_frame" | "last_frame"必填

这件素材的用途。

urlstring必填

公开可访问的 https 地址。该地址由模型拉取，本站不会访问它。

resolution"480P" | "768P"默认 "768P"

输出分辨率档。这是计价维度，单价按所选档位的每秒价算。这个模型只有 480P / 768P。⚠️ 上游把它定为必填，未提供时我们按 768P 送出并在任务的 notes 里说明。

durationinteger默认 5

出片秒数，5–15 的整数。这个模型没有智能时长（-1）。⚠️ 上游把它定为必填，未提供时我们按 5 送出并记 note。

aspect_ratio"adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"

画面比例。⚠️ 纯文生时不能用 adaptive（没有素材可跟），未提供则按 16:9 送出并记 note。

watermarkboolean默认 false

是否在输出视频上添加 AIGC 水印。

webhook_urlstring

任务到终态时回调这个地址。它就是站内的 webhook_url——我们只是改了个名字，投递内容与统一入口那条完全一致。必须是可投递的公网 https 地址。

响应

200response

任务已受理。拿 id 去 GET /v1/tasks/{id} 轮询。

400response

参数不合法、缺少提示词，或这个模型不收的素材角色。

402response

可用余额不足以覆盖预扣上界。

503response

当前没有可用的供应商能服务这个模型。

和原生形状的关系

计费、路由、预扣完全一致，只有线格式不同：

原生形状这一条
提示词与素材同一个 content[] 数组prompt + media[] 两个字段
素材用途rolemedia[].type
素材地址嵌套 image_url.url平铺 media[].url
比例参数名ratioaspect_ratio
取回时有用量与费用没有有

取值域

参数这个模型
resolution480P / 768P
duration5–15 的整数
aspect_ratioadaptive（需素材）/ 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
media[].type首帧、尾帧各 1。它不收任何参考素材

⚠️ prompt 必填，且纯文生时必须有一个具体的 aspect_ratio——未提供时 我们按 16:9 送出并在 notes 里说明。

计费

这个模型只按出片计费，输入素材一律不收钱（官方原话：暂不对输入素材计费）。

示例里那个 cost（0.25）是 480P × 5 秒 的价。

提交返回任务 ID

拿 id 去取回口轮询。 一段视频十几分钟很正常，不要把它挂在一条 HTTP 连接上等。

cURL
curl https://gateway.amux.ai/v1/tasks \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "minimax/minimax-h3-max",
    "prompt": "A ginger cat running through fresh snow, slow motion",
    "resolution": "768P",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
{
  "id": "task_01M1VD9E8WRYVBR7ES10SNQQQT",
  "status": "queued",
  "model": "minimax/minimax-h3-max",
  "created_at": "<string>",
  "output": {
    "images": [
      {}
    ],
    "videos": [
      {
        "index": 0,
        "url": "<string>"
      }
    ]
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0,
    "output_video_seconds": 0
  },
  "cost": "0.25",
  "notes": [
    "<string>"
  ],
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}