xAI 视频生成

Grok Imagine API

用文本或图片输入生成 Grok Imagine 短片。

Grok Imagine 支持基于 prompt 的文生视频,以及多图参考(在 prompt 中用 @image1、@image2 引用)。可选 480p / 720p、6-30 秒时长,以及 fun、normal、spicy 三档运动强度。和你接入的其他模型共用同一套任务、轮询、回调和积分余额体系。

查看 API 文档在线体验

Fun / Normal / Spicy

运动模式

6-30 秒

时长

480p / 720p

分辨率

xAI

grok-imagine-text-to-video异步任务

Fun / Normal / Spicy

运动模式

6-30 秒

时长

480p / 720p

分辨率

模型能力

为生产级 API 工作流设计，不只是演示。

Grok Imagine 与你接入的其他视频和图片模型共用同一套 API Key、积分、日志、Webhook 和文档体系。

文生视频

把 prompt 直接变成 6-30 秒的视频,支持自定义宽高比和运动强度。

多图参考

最多支持 7 张参考图,可在 prompt 中通过 @image1、@image2 等内联引用。

运动强度可调

文生视频可选 fun、normal、spicy 三档,匹配不同的创意尺度和动感需求。

统一异步任务

提交后立刻拿到 taskId,通过轮询或 webhook 回调获取生成结果。

API 工作流

提交任务、跟踪进度、取回生成结果。

选择输入类型

文生视频,或图生视频(一张或多张外部图片 URL)。

设置时长与分辨率

根据成本和效果在 6-30 秒、480p / 720p 之间选择。

接收任务结果

轮询任务接口或使用回调推送托管视频 URL。

POST /v1/videos/generations

curl -X POST https://api.aivideoapi.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-text-to-video",
    "input": {
      "prompt": "A couple of doors open in a surreal hallway, each revealing a tiny living room.",
      "aspect_ratio": "2:3",
      "duration": 6,
      "resolution": "480p"
    }
  }'

典型应用场景

超现实短场景

图片驱动的运动

多角色短片

创意快速迭代

动态参考镜头

社交平台短视频

为什么选择 Grok Imagine

开发者关心的 Grok Imagine API 优势。

xAI 原生视频模型

Grok Imagine 是 xAI 自研的首个视频生成模型,prompt 还原度高,擅长其他模型难以处理的超现实和反常规构图。

单次任务支持更长视频

单次任务可生成 6-30 秒视频,是 Veo 3.1 Fast、Kling 3.0、Sora 2 最短档时长上限的 3-5 倍,无需拼接多次任务。

支持多图内联引用

最多上传 7 张参考图,在 prompt 中通过 @image1、@image2 等标记内联引用。适合多角色场景和产品组合镜头。

三档运动强度可调

在 fun、normal、spicy 三档运动模式之间切换,无需重写 prompt 即可调整创意尺度和动感表现。

账户和运维统一

Grok Imagine 与平台上所有其他视频和图片模型共用同一份 API Key、积分余额、异步任务生命周期、Webhook 和日志体系。

按秒线性计费,透明可预测

成本随时长线性变化:480p 每秒 2.4 credits,720p 每秒 4.5 credits,没有隐藏倍数或额外费用。

常见问题

关于 Grok Imagine API 的常见问题解答。

Grok Imagine API 是什么?

Grok Imagine 是 xAI 的文生视频和图生视频模型。AI Video API 通过统一的 HTTP 接口(POST /v1/videos/generations)接入,积分、回调、日志体系与所有视频模型共享。

Grok Imagine 单次能生成多长的视频?

每次任务支持 6-30 秒视频输出。通过 input.duration 参数设置(整数,范围 6-30,默认 6)。

Grok Imagine 支持图生视频吗?

支持。在 input 对象中传入 image_urls(1-7 张公网 HTTP/HTTPS 图片 URL),并可在 prompt 中用 @image1、@image2 等标记引用。支持 JPEG、PNG、WEBP,每张最大 10MB。

Grok Imagine API 的价格是多少?

按分辨率每秒计费:480p 每秒 2.4 credits,720p 每秒 4.5 credits。6 秒 480p 约 15 credits,10 秒 720p 约 45 credits。1 credit = $0.005 USD。

fun、normal、spicy 三种模式有什么区别?

Mode 控制运动强度和创意尺度。fun 偏俏皮、normal 平衡、spicy 最具张力。文生视频支持三种,图生视频仅支持 fun 和 normal。

可以接收 webhook 回调通知吗?

可以。创建任务时传入 callback_url,平台会在任务完成(或失败)时 POST 结果到该地址。同时也可以通过 GET /v1/tasks/{taskId} 主动轮询。

定价与用量

清晰的模型选项，共享积分余额。

480p

2.4 credits/秒

低成本快速迭代

720p

4.5 credits/秒

更高画质输出

6 秒 @ 480p

约 15 credits

最短时长草稿

10 秒 @ 720p

约 45 credits

均衡的制作级短片

在 AI Video API 上开始使用 Grok Imagine。

一个 API Key、一份积分余额，在视频和图片模型之间无缝切换，无需为每家供应商单独接入。

阅读文档