Amux

Create task

最近更新：2026年9月6日

用 alibaba/happyhorse-1.1 提交异步任务，走站内统一入口。请求体平铺。

使用 alibaba/happyhorse-1.1 提交视频生成任务，走站内统一的异步入口。

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

鉴权

header
Authorizationstring必填

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

请求

application/json
modelstring必填

站内模型 ID，或三个能力别名之一

（happyhorse-1.1-t2v / -i2v / -r2v）。

promptstring

生成内容的描述。上限 5,000 个非中文字符或 2,500 个中文字符，

超出部分由上游截断而非报错。

参考图生视频时，用 [Image 1] [Image 2]（带方括号）

指代 media 中对应顺序的参考图。

mediaarray<object>

输入素材。只接受公开可访问的 https 地址。

首帧图与参考图互斥，它们属于两个不同的能力。

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

这件素材的用途，同时决定打上游哪个模型：

角色数量打到格式与限制
first_frame恰好 1 件-i2vJPEG/JPG/PNG/WEBP，≤20MB，单边 ≥300px，宽高比 1:2.5–2.5:1
reference_image1–9 件-r2v同上

两者不能混用。混用返回 400。

urlstring必填

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

resolution"480P" | "720P" | "1080P"默认 "1080P"

输出分辨率档位。该字段是计价维度。

aspect_ratio"16:9" | "9:16" | "4:3" | "3:4" | "4:5" | "5:4" | "1:1" | "9:21" | "21:9"默认 "16:9"

画面比例。本端点用 aspect_ratio，百炼原生端点用 ratio，

两者含义相同。没有 adaptive 这一档。

durationinteger默认 5

出片秒数，3–15。该模型没有 -1（智能时长）那一档。

seedinteger

随机种子，用于复现结果。

watermarkboolean默认 true

是否添加水印。该模型默认为 true。

webhook_urlstring

任务到终态时往这里 POST 一份结果。只收 https，且不能指向内网。

签名与验签见创建任务。

响应

200response

任务已建立。

400response

参数或素材不合法。

402response

余额不足以覆盖本次预扣。

503response

没有可用的供应链路，或本站在途任务已达上限。

与百炼原生端点只差两处

其余环节（路由、定价、预扣、幂等、限流、任务记录）完全一致：

百炼原生端点本端点
请求体嵌套（input.* / parameters.*）平铺
画面比例ratioaspect_ratio

本端点与厂商无关：接入其他视频上游时，使用本端点的代码无需修改； 百炼原生端点按定义仅适用于百炼的模型。

一个站内 ID，上游三个模型

上游把 HappyHorse 按能力拆成了三个模型，本站聚合成一个 ID。 打哪一个由你传的素材决定：

你传了什么打到上游的说明
只有 prompthappyhorse-1.1-t2v纯文生视频
一件 first_framehappyhorse-1.1-i2v首帧图生视频
1–9 件 reference_imagehappyhorse-1.1-r2v参考图生视频

也可以用能力别名点名，官方那三个 ID 本站都收，与聚合 ID 完全等价：

可用的 model 取值含义
alibaba/happyhorse-1.1 · happyhorse-1.1聚合 ID，由素材决定能力
happyhorse-1.1-t2v点名纯文生视频
happyhorse-1.1-i2v点名首帧图生视频
happyhorse-1.1-r2v点名参考图生视频

点名之后素材必须与之相符，否则返回 400，而不是被悄悄改成别的能力： 「你写着 -i2v、我们打了 r2v」在账单上看不出来，而片子已经出了。

三个能力价格完全相同，选哪个只影响生成方式。日志与取回结果里的 model 回显的是你自己写的那个名字。

输入素材

规则与百炼原生端点完全一致： 首帧图与参考图互斥、只收公开 https 地址、参考图用 [Image 1] 在提示词里指代。

与万相的差异

同一条协议上的两个系列，取值域逐项不同。从万相迁过来时这几处要改：

万相 3.0HappyHorse 1.1
时长2–30，或 -1（智能时长）3–15，没有 -1
比例含 adaptive（随素材）没有 adaptive，多出 4:5 5:4 9:21 21:9
audio可开关没有这个参数，恒有声
prompt_extend有没有
watermark 默认falsetrue
提示词上限20,000 字符5,000 非中文 / 2,500 中文
指代参考素材「图1」「视频1」[Image 1]（带方括号）
输出帧率30fps24fps

传了它没有的参数（audio / prompt_extend）会被摘掉， 并在任务的 result_meta.notes 里说明——不会因此报错，但也不会静默。

取值超出范围（比如 duration: 30）返回 400 并给出可接受的范围， 不会被静默替换成默认值。

计费

视频不产生 token。计费方式为该分辨率档的每秒单价 × 实际出片秒数， 输入素材不单独计价。三种能力同价。

提交时按上界预扣，任务完成后按实际用量结算并退还差额。 失败与超时不计费，预扣已释放。逐档单价见模型目录中该模型的详情页。

回调与幂等

任务生命周期、webhook_url 的签名与验签、幂等键、Prefer: wait 的说明见 创建任务。

错误

type 取值与重试语义见错误与重试。

cURL
curl https://gateway.amux.ai/v1/tasks \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.1",
    "prompt": "A ginger cat running through fresh snow, slow motion",
    "resolution": "1080P",
    "duration": 5
  }'
{
  "id": "task_01M1VD9E8WRYVBR7ES10SNQQQT",
  "status": "queued",
  "model": "alibaba/happyhorse-1.1",
  "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.185654",
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}