Ideogram · 圖像

Hermes Agent x Ideogram V3

Ideogram V3 專為生成圖片中的文字排版而打造，文字準確度很高。透過 RunAPI，所有 Ideogram V3 端點——生成、編輯與 remix——共用一組金鑰。

7 variants 起價 $0.07 / 次呼叫 可商用
取得 API Key 查看 Hermes Agent 文件

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: 不需提示詞即可變更圖片取景與畫面比例
  endpoints: /api/v1/ideogram_v3/reframe_image
  request fields: model, source_image_url, aspect_ratio
- ideogram-v3-remix: 以參考圖片 + 文字提示詞進行風格 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 進入終態。

使用 Hermes Agent + Ideogram V3 可以打造什麼

  • T 恤與周邊設計

    產生可直接印刷的周邊設計，標語、引言或品牌名稱以清晰文字呈現。

  • 行銷素材批次製作

    製作成套的海報、社群卡片、邀請函和資訊圖表，草稿用快速算圖，定稿用品質優先算圖。

  • 圖示與資訊圖表設計

    產生圖示組和資訊圖表，其中的標籤、數字和圖例不必手動修正即可正確顯示。

為什麼透過 RunAPI + Hermes Agent 使用 Ideogram V3

  • 7 個變體，一個 API 金鑰

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

  • 清楚的用量價格

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

  • 自動化工作流程

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

Hermes Agent + Ideogram V3 常見問題

如何在 Hermes Agent 中設定 Ideogram V3？

用你的 RunAPI API 金鑰在 Hermes Agent 中將 RunAPI 設定為提供者，之後同一個提供者即可存取本頁列出的所有 Ideogram V3 端點。

可以把一張圖的風格套用到另一張圖嗎？

可以。使用混合端點並傳入風格參考圖，在提示詞中描述新的構圖。結果會沿用參考圖的風格，同時遵循提示詞。

為 Ideogram V3 撰寫文字類提示詞有什麼要點？

寫明文字內容以及它該出現的位置。Hermes Agent 會原樣傳遞提示詞，模型會原生呈現文字。

應該使用哪個模型 ID？

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

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

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

開始在 Hermes Agent 中使用 Ideogram V3

取得 API Key 閱讀快速入門

正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

聯絡我們