可以在 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，並附上描述圖像的提示詞。影片生成請使用 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 模型串接，用於多步驟工作流程——例如生成產品照片後，再傳遞給影片模型製作動態內容。