---
title: "透過 RunAPI 在 Hermes Agent 中使用 Ideogram V3 — 圖片 API 指南"
url: "https://runapi.ai/zh-HK/hermes-ideogram-v3.md"
canonical: "https://runapi.ai/zh-HK/hermes-ideogram-v3"
locale: "zh-HK"
model: "ideogram-v3"
---

# 在 Hermes Agent 中使用 Ideogram V3。

Ideogram V3 生成具有業界領先文字渲染能力的圖片 — 在海報、logo 和標誌上呈現可閱讀的排版效果，而其他圖片模型往往難以做到。它提供三個端點（text_to_image、edit_image、remix_image）和一個 turbo 速度層級，以較低成本將生成時間減半。Hermes Agent 透過與 chat 相同的 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": "ideogram-v3-text-to-image",
    "prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
    "style": "design",
    "aspect_ratio": "3:4",
    "rendering_speed": "balanced"
  }'

```

### Response

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

```

## How it works

1. **設定 RunAPI** — 在你的 shell profile 中設定 RUNAPI_API_KEY 環境變數。如果 Hermes Agent 中已設定好 custom:runapi provider 用於 chat，相同的 key 即可用於 Ideogram V3 — 無需額外設定。
2. **呼叫 Ideogram V3** — 發送 POST 請求到 text_to_image 端點，model 設為 ideogram-v3-text-to-image。在 prompt 中包含你想在圖片中渲染的任何文字。將 style 設為 design 以製作海報和 logo，或設為 realistic 以輸出照片風格。使用 rendering_speed turbo 以更低成本獲得更快結果。
3. **取得結果** — API 會立即返回 task_id。輪詢任務狀態端點，直到 status 變為 completed，然後從回應中取得輸出圖片 URL。使用 output_count 每次請求最多可生成 4 張圖片。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。ideogram-v3-text-to-image、ideogram-v3-edit 或 ideogram-v3-remix。 |
| `prompt` | `string` | 描述所需圖片的文字。包含你想渲染的具體文字。 |
| `style` | `string` | 選填。auto、general、realistic 或 design。製作海報和 logo 時使用 design。 |
| `rendering_speed` | `string` | 選填。turbo（最快，最低成本）、balanced（預設）或 quality（最高細節）。 |
| `aspect_ratio` | `string` | 選填。1:1、3:4、9:16、4:3 或 16:9。 |
| `output_count` | `integer` | 選填。每次請求生成的圖片數量。1 到 4。 |
| `source_image_url` | `string` | edit 和 remix 端點必填。來源圖片的 URL。 |

## FAQ

### 與其他模型相比，Ideogram V3 如何處理圖片中的文字？

Ideogram V3 專為排版渲染而優化。它能產生可閱讀的多行文字、風格化標題和 logo 品質的字型，而 Flux 或 Imagen 等模型通常會產生亂碼。如果你的用途需要在海報、標誌或產品標籤上呈現精確文字，Ideogram V3 是 RunAPI 模型目錄中最強的選擇。

### turbo、balanced 和 quality 渲染速度有什麼差別？

Turbo 生成最快，成本約為 balanced 的一半。Quality 產生最高細節的輸出但需要更長時間。Balanced 是預設的折衷方案。三個層級使用相同的底層 Ideogram V3 模型 — 差異在於計算時間和精細度，而非模型版本。

### 如何在 Hermes Agent 中設定 custom:runapi provider 以使用 Ideogram V3？

在 Hermes Agent provider 設定中新增一個自訂 provider，base_url 為 https://runapi.ai/v1，並填入你的 RUNAPI_API_KEY。設定完成後，透過相同的 provider 即可呼叫任何 RunAPI 端點 — text_to_image、edit_image、remix_image。執行 hermes doctor 驗證連線。

### 可以使用 remix 模式將一張圖片的風格轉移到另一張嗎？

可以。使用 remix_image 端點搭配 ideogram-v3-remix。將 source_image_url 設為風格參考圖片，然後在 prompt 中描述新的構圖。輸出會繼承來源的視覺風格，同時依照文字 prompt 的內容生成。你也可以將 style 設為 design、realistic 或 general 來進一步引導輸出。

### 搭配 output_count 時的每張圖片定價如何？

每張生成的圖片單獨計費。如果你將 output_count 設為 4，則收取 4 張圖片的費用。每張圖片費率取決於你的 rendering_speed 設定 — turbo 成本約為 balanced 的一半。請查看 RunAPI 定價頁面了解目前費率。生成失敗不收費。


## Links

- [Hermes Agent 設定指南 →](https://runapi.ai/zh-HK/hermes-agent)
- [Ideogram V3 models →](https://runapi.ai/zh-HK/models/ideogram-v3)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)