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

# 在 Hermes Agent 中使用 Grok Imagine。

Grok Imagine 是 xAI 的圖像和影片生成套件——文字轉圖片、圖片轉圖片、文字轉影片和圖片轉影片。Hermes Agent 透過與聊天相同的 RunAPI 自訂 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 設定檔中設定 RUNAPI_API_KEY 環境變數。如果 Hermes Agent 中已設定 custom:runapi provider 用於聊天，同一個 key 亦適用於 Grok Imagine——無需額外設定。
2. **呼叫 Grok Imagine** — 向 text_to_image 端點發送 POST 請求，將 model 設為 grok-imagine-text-to-image，並附上描述圖像的 prompt。如需影片，以 grok-imagine-text-to-video 使用 text_to_video。
3. **取得結果** — API 立即返回 task_id。輪詢 task status 端點直到狀態變為 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。輪詢 task status 端點直到任務完成。RunAPI SDK 和 CLI 會自動處理輪詢。

### Grok Imagine 的收費是多少？

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


## Links

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