Create video
最近更新：2026年9月13日
用 `x-ai/grok-imagine-video` 出片，走 xAI 原生形状，现有 xAI 客户端直接可用。
使用 x-ai/grok-imagine-video 生成视频，请求体为 xAI 原生形状。现有 xAI 客户端只需将
base_url 指向本站即可，请求与响应的解析无需改动。
https://gateway.amux.ai/v1/videos/generations鉴权
headerAuthorizationstring必填Bearer <你的 Amux 密钥> 站内 API Key。
请求
application/jsonmodelstring必填固定为 x-ai/grok-imagine-video。
promptstring可选——提供任一素材时可省略；两者均未提供时返回 400。
durationinteger默认 8出片秒数，默认 8 秒。
⚠️ 含参考素材时上限为 10 秒，超出在提交时同步返回 400。
aspect_ratio"1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3"默认 "16:9"⚠️ 图生视频场景下不生效：输出宽高比跟随所提供的图片。
resolution"480p" | "720p"默认 "480p"计价档位，默认 480p（上游默认值）。
没有 1080p——该档位仅 x-ai/grok-imagine-video-1.5 支持，在本模型上请求会返回 400。
imageobject首帧图片。提供该字段即为图生视频模式。
›imageobject
urlstring首帧图片地址，须为公开可访问的 URL。
last_frameobject尾帧图片。与 image 同时提供即为首尾帧模式。
›last_frameobject
urlstring尾帧图片地址，须为公开可访问的 URL。
reference_imagesarray<object>风格与内容参考图，最多 14 张。
›reference_imagesarray<object>
urlstring参考图片地址，须为公开可访问的 URL。
generate_audioboolean默认 true默认生成音轨。 传 false 时输出不含音轨。
moderation"low" | "auto" | "high"内容审核强度。未提供时使用上游默认值。
userstring终端用户标识，用于滥用追踪。建议传入哈希值而非明文。
响应
200response任务已创建。
400response请求不合法（参数超出取值域、素材组合不成立、或提示词与素材均未提供）。
402response余额不足以完成本次任务的费用预留。
这个模型的取值域
| 分辨率 | 480p 720p |
| 时长 | 纯文生与图生 1–15 秒；含 reference_images 或 last_frame 时上限为 10 秒。 |
| 参考图 | 最多 14 张 |
| 提示词 | 可选，提供任一素材时可省略 |
⚠️ 本模型没有 1080p。 该档位仅 x-ai/grok-imagine-video-1.5 支持，
在本模型上请求会返回 400，不会静默降级。
上方参数表已按本模型收窄，列出的每一项都是它真正接受的。 取值超出范围时返回 400 并给出可接受的取值，不会被静默替换。
四种生成模式
模式由请求中提供的素材决定，无需额外声明：
| 模式 | 必要字段 |
|---|---|
| 文生视频 | 仅 prompt |
| 图生视频 | image（首帧） |
| 参考图生视频 | reference_images |
| 首尾帧 | image + last_frame |
⚠️ 图生视频场景下 aspect_ratio 与 resolution 不决定输出尺寸——
输出宽高比恒跟随所提供的图片。计费不受影响，仍按请求的 resolution 档位计算。
计费
费用 = 实际出片秒数 × 分辨率档单价 + 输入图片张数 × 单张单价
出片按秒计费，两档分辨率各有单价；输入图片按张计费，首帧、尾帧与参考图均计入。 逐档单价以模型详情页与定价页为准，那两处直接读价格表。
出片秒数取上游返回的实际值，而非请求中的 duration。
提交时按请求参数预留费用，完成后按实际用量结算并释放差额。
取回
curl https://gateway.amux.ai/v1/videos/generations \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "x-ai/grok-imagine-video",
"prompt": "A red paper boat drifting down a rain puddle, camera slowly pans out",
"duration": 8,
"resolution": "480p"
}'{
"request_id": "<string>"
}