Amux

Create video task

最近更新：2026年9月13日

用 `x-ai/grok-imagine-video-1.5` 出片，走站内统一形状，支持 `media[]` 与回调。

使用 x-ai/grok-imagine-video-1.5 生成视频，请求体为站内统一形状。

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

鉴权

header
Authorizationstring必填

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

请求

application/json
modelstring必填

固定为 x-ai/grok-imagine-video-1.5。

promptstring

可选——提供任一素材时可省略；两者均未提供时返回 400。

durationinteger默认 8

出片秒数，默认 8 秒。

aspect_ratio"1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3"默认 "16:9"

⚠️ 图生视频场景下不生效：输出宽高比跟随所提供的图片。

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

计价档位，默认 480p（上游默认值）。

三档全部支持。

imageobject

首帧图片。提供该字段即为图生视频模式。

›imageobject
urlstring

首帧图片地址，须为公开可访问的 URL。

last_frameobject

尾帧图片。与 image 同时提供即为首尾帧模式。

›last_frameobject
urlstring

尾帧图片地址，须为公开可访问的 URL。

reference_imagesarray<object>

风格与内容参考图，最多 14 张。

›reference_imagesarray<object>
urlstring

参考图片地址，须为公开可访问的 URL。

audioboolean默认 true

默认生成音轨。 传 false 时输出不含音轨。

moderation"low" | "auto" | "high"

内容审核强度。未提供时使用上游默认值。

userstring

终端用户标识，用于滥用追踪。建议传入哈希值而非明文。

mediaarray<object>

输入素材的统一写法，与上面四个专有字段二选一。每项形如 {{"type":"first_frame","url":"…"}}，type 取 first_frame / last_frame / reference_image。

›mediaarray<object>
typestring

素材角色。

urlstring

素材地址。

webhook_urlstring

任务进入终态后回调该地址，可免去轮询。

响应

200response

任务已创建，返回统一任务形状。

400response

请求不合法（参数超出取值域、素材组合不成立、或提示词与素材均未提供）。

402response

余额不足以完成本次任务的费用预留。

与 xAI 原生形状的区别只在写法： 同一个模型、同一套取值域、同一份计费。统一形状多两样东西：

  • media[]——输入素材的统一写法，与 image / last_frame / reference_images 三个专有字段二选一；
  • webhook_url——任务进入终态后回调，可免去轮询。

跨厂商调度多个模型时建议用这一条，可以只维护一套请求构造逻辑。

素材写法对照

// xAI 原生形状
{ "image": { "url": "https://…/a.png" } }

// 站内统一形状
{ "media": [{ "type": "first_frame", "url": "https://…/a.png" }] }

type 取 first_frame / last_frame / reference_image。

取值域与计费

与 xAI 原生形状那条完全一致， 此处不再重复。

cURL
curl https://gateway.amux.ai/v1/tasks \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "x-ai/grok-imagine-video-1.5",
    "prompt": "A red paper boat drifting down a rain puddle, camera slowly pans out",
    "duration": 8,
    "resolution": "480p"
  }'
{
  "id": "task_01M2D8FH1TKGP6VJJX1X3SYY7Q",
  "status": "queued",
  "model": "x-ai/grok-imagine-video-1.5",
  "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.08",
  "notes": [
    "<string>"
  ],
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}