---
title: "在 Hermes Agent 中透過 RunAPI 使用 Grok Imagine — 圖像與影片 API 指南"
url: "https://runapi.ai/zh-TW/hermes-grok-imagine.md"
canonical: "https://runapi.ai/zh-TW/hermes-grok-imagine"
locale: "zh-TW"
model: "grok-imagine"
---

# 在 Hermes Agent 中使用 Grok Imagine。

Grok Imagine 是 xAI 的圖像和影片生成套件——文生圖、圖生圖、文生影片和圖生影片。Hermes Agent 透過與聊天相同的 RunAPI custom provider 和 API key 呼叫它，無需安裝額外外掛。

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **設定 RunAPI** — 在 shell profile 中設定 RUNAPI_API_KEY 環境變數。若 Hermes Agent 中已設定 custom:runapi provider 用於聊天，同一個 key 也適用於 Grok Imagine，無需額外設定。
2. **呼叫 Grok Imagine** — 向 text_to_image 端點發送 POST 請求，將 model 設為 grok-imagine-text-to-image，並附上描述圖像的提示詞。影片生成請使用 text_to_video 和 grok-imagine-text-to-video。
3. **取得結果** — API 立即傳回 task_id。輪詢任務狀態端點，直到狀態變為 completed，然後從回應中取得輸出圖像或影片 URL。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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。 |

## FAQ

### 可以在 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 定價頁面取得最新價格。生成失敗不收費。


## Links

- [Hermes Agent 設定指南 →](https://runapi.ai/zh-TW/hermes-agent)
- [Grok Imagine 模型 →](https://runapi.ai/zh-TW/models/grok-imagine)
- [Model catalog](https://runapi.ai/zh-TW/models)
- [API docs](https://runapi.ai/zh-TW/docs)