xAI · 视频

OpenClaw x Grok Imagine

Grok Imagine 是 xAI 基于 Grok 构建的创意 AI 套件,涵盖图像和视频生成。通过 RunAPI,所有 Grok Imagine 端点共享一把 key。

7 variants 起价 $0.02 / 秒 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任务匹配时使用 grok-imagine-edit-image:基于一张或多张来源图像的提示词风格迁移和构图编辑。

You have access to RunAPI task tools for Grok Imagine.

Available Grok Imagine models:
- grok-imagine-edit-image: 基于一张或多张来源图像的提示词风格迁移和构图编辑
  endpoints: /api/v1/grok_imagine/edit_image
  request fields: model, source_image_url, prompt
- grok-imagine-image-2-0: 文生图、分割图与局部精准编辑
  endpoints: /api/v1/grok_imagine/edit_image, /api/v1/grok_imagine/segment_map, /api/v1/grok_imagine/text_to_image
  request fields: model, prompt, aspect_ratio
- grok-imagine-image-to-video: 输入图像为首帧;运动 + 镜头运动动画
  endpoints: /api/v1/grok_imagine/image_to_video
  request fields: model, source_image_url, prompt
- grok-imagine-text-to-image: Aurora 模型;5 种宽高比;写实/艺术/动漫风格
  endpoints: /api/v1/grok_imagine/text_to_image
  request fields: model, prompt
- grok-imagine-text-to-video: 6–30 秒文生视频,原生音频同步和唇形同步
  endpoints: /api/v1/grok_imagine/text_to_video
  request fields: model, prompt
- grok-imagine-video-1.5-fast: 快速文生/图生视频,适合高频创作迭代
  endpoints: /api/v1/grok_imagine/image_to_video, /api/v1/grok_imagine/text_to_video
  request fields: model, prompt
- grok-imagine-video-1.5-preview: Video 1.5 预览;支持文生/图生;auto 宽高比;最长 15 秒
  endpoints: /api/v1/grok_imagine/image_to_video, /api/v1/grok_imagine/text_to_video
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: 生成一段机械手在棋盘上落子的短视频,戏剧性打光,慢动作。
/api/v1/grok_imagine/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/edit_image,并保存返回的 Task ID。
GET /api/v1/grok_imagine/edit_image/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/grok_imagine/segment_map: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/segment_map,并保存返回的 Task ID。
GET /api/v1/grok_imagine/segment_map/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/grok_imagine/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/text_to_image,并保存返回的 Task ID。
GET /api/v1/grok_imagine/text_to_image/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/grok_imagine/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/image_to_video,并保存返回的 Task ID。
GET /api/v1/grok_imagine/image_to_video/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/grok_imagine/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/text_to_video,并保存返回的 Task ID。
GET /api/v1/grok_imagine/text_to_video/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。

公开版本与端点

模型 ID 端点 起步价格 模型目录
grok-imagine-edit-image
/api/v1/grok_imagine/edit_image
$0.04 / 次调用 模型详情
grok-imagine-image-2-0
/api/v1/grok_imagine/edit_image /api/v1/grok_imagine/segment_map /api/v1/grok_imagine/text_to_image
$0.04 / 次调用 模型详情
grok-imagine-image-to-video
/api/v1/grok_imagine/image_to_video
$0.02 / 秒 模型详情
grok-imagine-text-to-image
/api/v1/grok_imagine/text_to_image
$0.04 / 次调用 模型详情
grok-imagine-text-to-video
/api/v1/grok_imagine/text_to_video
$0.02 / 秒 模型详情
grok-imagine-video-1.5-fast
/api/v1/grok_imagine/image_to_video /api/v1/grok_imagine/text_to_video
$0.57 / 次调用 模型详情
grok-imagine-video-1.5-preview
/api/v1/grok_imagine/image_to_video /api/v1/grok_imagine/text_to_video
$0.08 / 秒 模型详情

验证

轮询,直到 Task 进入终态

选择 <model-id> 后生成验证命令。

配置

指南端点: <endpoint>

选择 <model-id> 后,按端点的公开输入契约生成请求。

其他操作

这些操作不使用模型 ID。

  • /api/v1/grok_imagine/extend_video
  • /api/v1/grok_imagine/upscale_image
使用流程

三步开始使用

  1. 选择模型 ID

    选择公开模型 ID,并查看其端点与当前起步价格。

  2. 配置 RunAPI

    调用端点前设置 RUNAPI_API_KEY。

  3. 验证结果

    对于异步端点,轮询同一端点,直到 Task 进入终态。

使用 OpenClaw + Grok Imagine 可以构建什么

  • 写实人像生成

    根据文字描述生成写实人像和角色图,用于社交头像、营销人设或创意项目。

  • 社交媒体内容创作

    直接用文字提示词生成图片和短视频片段,用于帖子、快拍和广告。

  • 风格化插画与动漫角色

    根据详细提示词创作插画风格图像和动漫角色,为游戏、品牌或系列内容保持一致的角色设计。

为什么通过 RunAPI + OpenClaw 使用 Grok Imagine

  • 7 个变体,一个 API 密钥

    通过一个 RunAPI 连接选择可用的模型变体,无需更改现有集成。

  • 清晰的用量价格

    发送请求前查看目录中的当前价格,无需订阅或最低消费。

  • 自动化任务流程

    通过一致的任务流程提交任务、查询状态并收集异步结果,无需编写手动轮询代码。

OpenClaw + Grok Imagine 常见问题

可以在 OpenClaw 中使用 Grok Imagine 吗?

可以。如果 RunAPI 已在 OpenClaw 中配置为提供方,同一个 API 密钥就能用于 Grok Imagine 的图片和视频任务。选择本页列出的版本和端点即可。

需要订阅 Grok 吗?

不需要。通过 RunAPI 使用 Grok Imagine 时按任务从 RunAPI 余额扣费,无需单独的 Grok 套餐或账号。

Grok Imagine 除了图片还能生成视频吗?

可以。Grok Imagine 提供图片和视频端点。本页的版本与端点部分列出了每个变体支持的能力。

应该使用哪个模型 ID?

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

本指南会配置聊天模型吗?

不会。该 Model Line 使用页面所示的端点流程,不会被描述为 Agent 聊天模型。

开始在 OpenClaw 中使用 Grok Imagine

需要团队接入支持?

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们