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

可以。如果 RunAPI 已在 Hermes Agent 中配置为 custom provider（custom:runapi），同一个 API key 和 base_url 也适用于 Grok Imagine。将 model 设为 grok-imagine-text-to-image 并调用 text_to_image 端点。

Grok Imagine 需要单独的 API key 吗？

不需要。用于聊天和其他模型的同一个 RUNAPI_API_KEY 也适用于 Grok Imagine。一个 key 覆盖 RunAPI 目录中 113+ 个模型。

Grok Imagine 是异步还是同步的？

异步。API 立即返回 task_id。轮询任务状态端点直到任务完成。RunAPI SDK 和 CLI 会自动处理轮询。

Grok Imagine 的价格是多少？

Grok Imagine 通过 RunAPI 按任务计费。查看 RunAPI 定价页面获取最新价格。生成失败不收费。

HERMES + GROK IMAGINE

在 Hermes Agent 中使用 Grok Imagine。

Grok Imagine 是 xAI 的图像和视频生成套件——文生图、图生图、文生视频和图生视频。Hermes Agent 通过与聊天相同的 RunAPI custom provider 和 API key 调用它，无需安装额外插件。

获取 API Key 阅读文档

一个 API key · 文生图端点 · 异步任务轮询

Use RunAPI to generate an image with xAI Grok Imagine.

Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Use the custom:runapi provider already configured in Hermes Agent.
- Set the model to "grok-imagine-text-to-image".
- Write a descriptive prompt for the image you want.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

复制 curl 命令进行测试 grok-imagine

工作原理

三步在 Hermes Agent 中使用 Grok Imagine

配置 RunAPI

在 shell profile 中设置 RUNAPI_API_KEY 环境变量。如果 Hermes Agent 中已配置 custom:runapi provider 用于聊天，同一个 key 也适用于 Grok Imagine，无需额外配置。

export RUNAPI_API_KEY=runapi_xxx

调用 Grok Imagine

向 text_to_image 端点发送 POST 请求，将 model 设为 grok-imagine-text-to-image，并附上描述图像的 prompt。视频生成请使用 text_to_video 和 grok-imagine-text-to-video。

text_to_image

获取结果

API 立即返回 task_id。轮询任务状态端点，直到状态变为 completed，然后从响应中获取输出图像或视频 URL。

task_id: tsk_abc123

参数

Grok Imagine API 参数

参数	类型	说明
`model`	`string`	必填。例如 grok-imagine-text-to-image、grok-imagine-image-to-video。
`prompt`	`string`	对所需输出的文字描述。
`image_url`	`string`	图生图或图生视频的源图像 URL。
`aspect_ratio`	`string`	可选。输出宽高比，例如 16:9、1:1。

Hermes Agent 上的 Grok Imagine 是什么？

Grok Imagine（Aurora）是 xAI 的图像和视频生成器，涵盖文生图、图像编辑以及带音频同步的文生视频。Hermes Agent 通过 custom:runapi provider 调用它，便于将 Grok Imagine 的输出与其他 RunAPI 模型组合——例如先生成产品图，再传给视频模型制作动态内容。