在 Hermes Agent 中使用 Ideogram V3。
Ideogram V3 生成具有業界領先文字渲染能力的圖片 — 在海報、logo 和標誌上呈現可閱讀的排版效果，而其他圖片模型往往難以做到。它提供三個端點（text_to_image、edit_image、remix_image）和一個 turbo 速度層級，以較低成本將生成時間減半。Hermes Agent 透過與 chat 相同的 RunAPI 自訂 provider 和 API key 呼叫它，無需安裝額外外掛。
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"
}
三個步驟在 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 呼叫它。
Ideogram V3 使用場景
客户交付物的商業設計
生成可直接用於客户交付的專業設計——橫幅、封面圖和營銷素材——無需在風格過於藝術化的輸出上進行大量手工調整。
帶文字疊加的社交媒體內容
批量生成 Instagram、LinkedIn 或 Twitter 的帖子視覺內容，附有精準的文字疊加，Ideogram 的高文字準確率確保一次成功。
多格式品牌套件
在 Hermes Agent 工作流中為同一品牌資產生成多種格式——橫版、豎版、正方形——用 Ideogram 的混合創作模式保持跨格式的視覺一致性。
Ideogram V3 + Hermes Agent 常見問題
Ideogram V3 專為排版渲染而優化。它能產生可閱讀的多行文字、風格化標題和 logo 品質的字型，而 Flux 或 Imagen 等模型通常會產生亂碼。如果你的用途需要在海報、標誌或產品標籤上呈現精確文字，Ideogram V3 是 RunAPI 模型目錄中最強的選擇。
Turbo 生成最快，成本約為 balanced 的一半。Quality 產生最高細節的輸出但需要更長時間。Balanced 是預設的折衷方案。三個層級使用相同的底層 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_image 端點搭配 ideogram-v3-remix。將 source_image_url 設為風格參考圖片，然後在 prompt 中描述新的構圖。輸出會繼承來源的視覺風格，同時依照文字 prompt 的內容生成。你也可以將 style 設為 design、realistic 或 general 來進一步引導輸出。
每張生成的圖片單獨計費。如果你將 output_count 設為 4，則收取 4 張圖片的費用。每張圖片費率取決於你的 rendering_speed 設定 — turbo 成本約為 balanced 的一半。請查看 RunAPI 定價頁面了解目前費率。生成失敗不收費。
立即在 Hermes Agent 中試用 Ideogram V3。
取得免費的 RunAPI key，設定 custom:runapi provider，即可使用 Ideogram V3 開始生成具有精確排版的圖片。