Ideogram · 圖像

OpenClaw x Ideogram V3

Ideogram V3 專為生成圖片中的文字排版而設計，文字準確度出色。透過 RunAPI，所有 Ideogram V3 端點——生成、編輯及 remix——共用同一個 key。

7 variants 由 $0.07 / 次請求 可商用
取得 API Key 查看 OpenClaw 文件

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 ideogram-v3-character：以一張固定身份圖片進行角色參考生成。

You have access to RunAPI task tools for Ideogram V3.

Available Ideogram V3 models:
- ideogram-v3-character: 以一張固定身份圖片進行角色參考生成
  endpoints: /api/v1/ideogram_v3/text_to_image
  request fields: model, prompt, aspect_ratio, reference_image_urls
- ideogram-v3-character-edit: 局部重繪，同時保留參考角色的身份特徵
  endpoints: /api/v1/ideogram_v3/edit_image
  request fields: model, prompt, source_image_url, mask_url, reference_image_urls
- ideogram-v3-character-remix: 以角色及風格參考 remix 來源圖片
  endpoints: /api/v1/ideogram_v3/remix_image
  request fields: model, prompt, source_image_url, reference_image_urls
- ideogram-v3-edit: 針對性編輯，同時保持文字準確度
  endpoints: /api/v1/ideogram_v3/edit_image
  request fields: model, prompt, source_image_url, mask_url
- ideogram-v3-reframe: 毋須 prompt 即可改變圖片取景及畫面比例
  endpoints: /api/v1/ideogram_v3/reframe_image
  request fields: model, source_image_url, aspect_ratio
- ideogram-v3-remix: 根據參考圖片 + 文字 prompt 進行風格 remix
  endpoints: /api/v1/ideogram_v3/remix_image
  request fields: model, prompt, source_image_url
- ideogram-v3-text-to-image: 圖片內文字準確度出色；最適合文字較多的圖片
  endpoints: /api/v1/ideogram_v3/text_to_image
  request fields: model, prompt, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: 為《The Last Frontier》製作一張電影海報，頂部以粗體襯線字顯示標題，背景是一座太空站。
/api/v1/ideogram_v3/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/ideogram_v3/text_to_image，並儲存回傳的 Task ID。
GET /api/v1/ideogram_v3/text_to_image/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/ideogram_v3/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/ideogram_v3/edit_image，並儲存回傳的 Task ID。
GET /api/v1/ideogram_v3/edit_image/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/ideogram_v3/remix_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/ideogram_v3/remix_image，並儲存回傳的 Task ID。
GET /api/v1/ideogram_v3/remix_image/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/ideogram_v3/reframe_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/ideogram_v3/reframe_image，並儲存回傳的 Task ID。
GET /api/v1/ideogram_v3/reframe_image/<task-id>，直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
ideogram-v3-character
/api/v1/ideogram_v3/text_to_image
$0.18 / 次請求 模型詳情
ideogram-v3-character-edit
/api/v1/ideogram_v3/edit_image
$0.18 / 次請求 模型詳情
ideogram-v3-character-remix
/api/v1/ideogram_v3/remix_image
$0.18 / 次請求 模型詳情
ideogram-v3-edit
/api/v1/ideogram_v3/edit_image
$0.07 / 次請求 模型詳情
ideogram-v3-reframe
/api/v1/ideogram_v3/reframe_image
$0.07 / 次請求 模型詳情
ideogram-v3-remix
/api/v1/ideogram_v3/remix_image
$0.07 / 次請求 模型詳情
ideogram-v3-text-to-image
/api/v1/ideogram_v3/text_to_image
$0.07 / 次請求 模型詳情

驗證

輪詢，直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後，依端點的公開輸入契約產生請求。
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID，並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑，直到 Task 進入終態。

使用 OpenClaw + Ideogram V3 可以建立甚麼

  • Logo 與品牌形象探索

    生成公司名稱拼寫正確的 Logo 方案，不必手動排字就能探索多個視覺方向。

  • YouTube 縮圖與社交圖片

    製作文字醒目、清楚可讀的縮圖、Pinterest 圖釘和社交媒體圖片。

  • 商品樣圖與電商頁面

    生成標籤和賣點文字正確的商品樣圖，用於客戶提案或商品頁。

為甚麼透過 RunAPI + OpenClaw 使用 Ideogram V3

  • 7 個變體，一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體，無需更改現有整合。

  • 清晰的用量價格

    發送請求前查看目錄中的目前價格，無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果，無需編寫手動輪詢程式碼。

OpenClaw + Ideogram V3 常見問題

Ideogram V3 處理圖中文字的效果如何？

Ideogram V3 針對文字排版做了優化，可以生成清楚的多行文字、風格化標題和 Logo 等級的字體，適合海報、招牌和商品標籤。

不同的渲染速度選項有什麼差別？

較快的渲染出圖更快、成本更低；質素優先的渲染耗時較長、細節更多。所有選項使用的都是同一個 Ideogram V3 模型。

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

可以。編輯端點會依提示詞修改來源圖，混合端點則把來源圖的風格套用到新的構圖上。

應該使用哪個模型 ID？

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

本指南會設定聊天模型嗎？

不會。此 Model Line 使用頁面所示的端點流程，不會被描述為 Agent 聊天模型。

透過 OpenClaw 開始使用 Ideogram V3

取得 API Key 閱讀快速開始

正在與團隊一起建立？

我們可以協助企業設定、整合和技術問題。

聯絡我們