---
title: "透過 RunAPI 在 Hermes Agent 中使用 Imagen 4 — 圖像 API 指南"
url: "https://runapi.ai/zh-HK/hermes-imagen-4.md"
canonical: "https://runapi.ai/zh-HK/hermes-imagen-4"
locale: "zh-HK"
model: "imagen-4"
---

# 在 Hermes Agent 中使用 Imagen 4。

Imagen 4 是 Google DeepMind 的圖像生成模型，具備準確的文字渲染和高 prompt 保真度。Hermes Agent 透過與聊天相同的 RunAPI 自訂 provider 端點呼叫它——無需 ComfyUI 或 GPU 設定。

## 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": "imagen-4",
    "prompt": "A ceramic coffee mug on a wooden table with morning light, the text HELLO printed on the side in serif font, photorealistic"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "imagen-4"
}

```

## How it works

1. **設定 RunAPI** — 設定 RUNAPI_API_KEY 環境變數。如果你已在 Hermes Agent 中將 RunAPI 設定為 custom:runapi provider 用於聊天，同一個 key 和 base_url 亦適用於圖像生成。
2. **呼叫 Imagen 4** — 向 text_to_image 端點發送 POST 請求，將 model 設為 imagen-4，並附上描述性 prompt。如有需要，可加入 aspect_ratio 或 negative_prompt。
3. **取得結果** — 回應包含 task_id。輪詢 task status 端點直到狀態變為 completed。完成的回應包含生成的圖像 URL。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。imagen-4、imagen-4-fast 或 imagen-4-ultra。 |
| `prompt` | `string` | 描述所需圖像的文字。 |
| `aspect_ratio` | `string` | 可選。例如 1:1、16:9、9:16。 |
| `negative_prompt` | `string` | 可選。在生成圖像中需要避免的內容。 |

## FAQ

### 我可以在 Hermes Agent 中使用 Imagen 4 嗎？

可以。Hermes Agent 透過 RunAPI text_to_image 端點呼叫 Imagen 4。將 model 欄位設為 imagen-4，使用與 custom:runapi provider 相同的 RUNAPI_API_KEY 發送請求即可。無需 ComfyUI 或 GPU 租用。

### 使用 Imagen 4 需要獨立的 API key 嗎？

不需要。同一個 RUNAPI_API_KEY 適用於所有 113+ 個模型——聊天、圖像、影片和音樂。一個 key，一個計費帳戶。

### Imagen 4 是非同步還是同步？

Imagen 4 是非同步的。初始請求返回狀態為 pending 的 task_id。輪詢 task status 端點直到任務完成，然後從回應中取得圖像 URL。RunAPI SDK 會自動處理輪詢。

### 透過 RunAPI 使用 Imagen 4 的收費是多少？

Imagen 4 按用量付費，無最低月費。費用因版本而異：imagen-4-fast 最便宜，imagen-4 為標準，imagen-4-ultra 畫質最高。請查看 RunAPI 收費頁面了解每張圖片的最新價格。


## Links

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