與其他模型相比，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 定價頁面了解目前費率。生成失敗不收費。

HERMES + 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 Key 閱讀說明文件

一個 API key · 排版優先的生成 · turbo 速度層級

Use RunAPI to generate an image with accurate text rendering using Ideogram V3.

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 "ideogram-v3-text-to-image".
- Write a prompt that includes specific text you want rendered in the image.
- Optionally set rendering_speed to turbo for faster generation, or quality for best results.
- 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": "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"
  }'

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

複製 curl 指令進行測試 ideogram-v3

運作原理

三個步驟在 Hermes Agent 中使用 Ideogram V3

設定 RunAPI

在你的 shell profile 中設定 RUNAPI_API_KEY 環境變數。如果 Hermes Agent 中已設定好 custom:runapi provider 用於 chat，相同的 key 即可用於 Ideogram V3 — 無需額外設定。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Ideogram V3

發送 POST 請求到 text_to_image 端點，model 設為 ideogram-v3-text-to-image。在 prompt 中包含你想在圖片中渲染的任何文字。將 style 設為 design 以製作海報和 logo，或設為 realistic 以輸出照片風格。使用 rendering_speed turbo 以更低成本獲得更快結果。

POST /v1/text_to_image

取得結果

API 會立即返回 task_id。輪詢任務狀態端點，直到 status 變為 completed，然後從回應中取得輸出圖片 URL。使用 output_count 每次請求最多可生成 4 張圖片。

task_id: tsk_abc123

參數

Ideogram V3 API 參數

參數	類型	說明
`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。

Hermes Agent 上的 Ideogram V3 是什麼？

Ideogram V3 是使用者描述為商業工作「最佳平衡點」的實用設計工具——它生成乾淨、商業可用的圖像，而其他模型生成「藝廊級」輸出卻不適用於實際客戶交付物。它支援編輯、混音和 turbo 速度層級，讓你能按任務平衡成本與品質。Hermes Agent 透過 RunAPI custom provider 呼叫它。