我可以在 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。輪詢 task status 端點直到任務完成。RunAPI SDK 和 CLI 會自動處理輪詢。

Grok Imagine 的收費是多少？

Grok Imagine 透過 RunAPI 按任務計費。請查看 RunAPI 收費頁面了解最新價格。生成失敗不收費。

HERMES + GROK IMAGINE

在 Hermes Agent 中使用 Grok Imagine。

Grok Imagine 是 xAI 的圖像和影片生成套件——文字轉圖片、圖片轉圖片、文字轉影片和圖片轉影片。Hermes Agent 透過與聊天相同的 RunAPI 自訂 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 設定檔中設定 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。如需影片，以 grok-imagine-text-to-video 使用 text_to_video。

text_to_image

取得結果

API 立即返回 task_id。輪詢 task status 端點直到狀態變為 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 模型組合——例如先生成產品圖，再傳給影片模型製作動態內容。