在 OpenClaw 中使用 Ideogram V3。
Ideogram V3 生成具有業界領先文字渲染能力的圖片 — 在海報、logo 和標誌上呈現可閱讀的排版效果，而其他圖片模型往往難以做到。它提供三個端點（text_to_image、edit_image、remix_image）和一個 turbo 速度層級，以較低成本將生成時間減半。OpenClaw agent 透過與 chat 相同的 RunAPI key 和 /v1 端點呼叫它，無需安裝額外 skill。
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"
}
三個步驟在 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 是圖像生成文字排版領域的領先模型，能精準呈現清晰專業的文字，在一兩次嘗試內達到 90-95% 的文字準確率，支持風格參考以保持品牌一致性。OpenClaw agent 通過與聊天相同的 RunAPI key 呼叫它。
Ideogram V3 使用場景
廣告與營銷視覺中的文字排版
生成文字清晰、整潔的社交媒體廣告、橫幅和推廣素材，首次生成即可使用，無需多次重試才能獲得可讀的文字。
品牌視覺與標誌設計
創作帶精準文字渲染和一致視覺風格的品牌素材。使用風格參考在生成的各項素材中保持品牌識別度。
電商產品展示圖
生成展示產品名稱、價格或功能文字的商品圖片，文字準確嵌入圖像中，可直接用於列表頁面，無需後期文字疊加。
Ideogram V3 + OpenClaw 常見問題
Ideogram V3 專為排版渲染而優化。它能產生可閱讀的多行文字、風格化標題和 logo 品質的字型，而 Flux 或 Imagen 等模型通常會產生亂碼。如果你的用途需要在海報、標誌或產品標籤上呈現精確文字，Ideogram V3 是 RunAPI 模型目錄中最強的選擇。
Turbo 生成最快，成本約為 balanced 的一半。Quality 產生最高細節的輸出但需要更長時間。Balanced 是預設的折衷方案。三個層級使用相同的底層 Ideogram V3 模型 — 差異在於計算時間和精細度，而非模型版本。
可以。使用 edit_image 端點搭配 ideogram-v3-edit，以文字 prompt 引導修改來源圖片。使用 remix_image 端點搭配 ideogram-v3-remix，將來源圖片的風格轉移到新的構圖。兩者都需要 source_image_url 參數。
每張生成的圖片單獨計費。如果你將 output_count 設為 4，則收取 4 張圖片的費用。每張圖片費率取決於你的 rendering_speed 設定 — turbo 成本約為 balanced 的一半。請查看 RunAPI 定價頁面了解目前費率。
非同步。API 會立即返回 task_id。輪詢任務狀態端點直到任務完成。RunAPI SDK 和 CLI 會自動處理輪詢。生成失敗不收費。
立即在 OpenClaw 中試用 Ideogram V3。
取得免費的 RunAPI key，將 prompt 貼入 OpenClaw，即可使用 Ideogram V3 開始生成具有精確排版的圖片。