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

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

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

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

可以用 Ideogram V3 編輯或混合現有圖片嗎？

可以。使用 edit_image 端點搭配 ideogram-v3-edit，以文字 prompt 引導修改來源圖片。使用 remix_image 端點搭配 ideogram-v3-remix，將來源圖片的風格轉移到新的構圖。兩者都需要 source_image_url 參數。

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

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

Ideogram V3 是非同步還是同步？

非同步。API 會立即返回 task_id。輪詢任務狀態端點直到任務完成。RunAPI SDK 和 CLI 會自動處理輪詢。生成失敗不收費。

OPENCLAW + IDEOGRAM V3

在 OpenClaw 中使用 Ideogram V3。

Ideogram V3 生成具有業界領先文字渲染能力的圖片 — 在海報、logo 和標誌上呈現可閱讀的排版效果，而其他圖片模型往往難以做到。它提供三個端點（text_to_image、edit_image、remix_image）和一個 turbo 速度層級，以較低成本將生成時間減半。OpenClaw agent 透過與 chat 相同的 RunAPI key 和 /v1 端點呼叫它，無需安裝額外 skill。

取得 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.
- 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

運作原理

三個步驟在 OpenClaw 中使用 Ideogram V3

設定 RunAPI

在你的 shell profile 中設定 RUNAPI_API_KEY 環境變數。如果 RunAPI 已在 OpenClaw 中為 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。

OpenClaw 上的 Ideogram V3 是什麼？

Ideogram V3 是使用者稱為圖像生成排版「遊戲規則改變者」的模型——它能釘牢清晰、專業的文字，而競品如 Midjourney 需要嘗試 15 次以上仍無法達到可讀效果。它在首次或第二次嘗試時達到 90-95% 的文字準確率，並支援風格參考以保持品牌一致性。OpenClaw 代理透過與聊天相同的 RunAPI key 呼叫它。