xAI · 视频

Hermes Agent x Grok Imagine

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

7 variants 起价 $0.02 / 秒 可商用
获取 API Key 查看 Hermes Agent 文档

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 进入终态。

使用 Hermes Agent + Grok Imagine 可以构建什么

  • AI 生成商品图

    根据文字描述生成商品图，用于电商商品页、产品目录或广告活动，无需实拍。

  • 社交媒体视频片段

    用文字提示词生成短视频片段，用于短视频、新品预告或内容营销。

  • 创意项目角色设计

    为游戏、故事或品牌项目设计写实或动漫风格的一致角色。

为什么通过 RunAPI + Hermes Agent 使用 Grok Imagine

  • 7 个变体，一个 API 密钥

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

  • 清晰的用量价格

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

  • 自动化任务流程

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

Hermes Agent + Grok Imagine 常见问题

可以在 Hermes Agent 中使用 Grok Imagine 吗？

可以。如果 RunAPI 已在 Hermes Agent 中配置为提供方，同一个 API 密钥就能用于 Grok Imagine。选择本页列出的版本和端点即可。

需要订阅 Grok 吗？

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

Hermes Agent 能把 Grok Imagine 和其他图像模型一起用吗？

可以。Hermes Agent 可以先用 Grok Imagine 生成初稿，再在同一工作流中把结果交给编辑或放大模型，全程只用一个 RunAPI 密钥。

应该使用哪个模型 ID？

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

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

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

开始在 Hermes Agent 中使用 Grok Imagine

获取 API Key 阅读快速开始

需要团队接入支持？

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

联系我们