Ideogram · 图像

Hermes Agent x Ideogram V3

Ideogram V3 专为图像中的排版而生，文字准确率业界领先。通过 RunAPI，所有 Ideogram V3 端点——生成、编辑和混搭——共享一把 key。

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: 结合原图、角色参考与风格参考进行重混
  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: 参考图 + 文字提示的风格混搭
  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: 创建一张电影海报，标题 '最后的边疆' 用粗体衬线字在顶部，背景是太空站。
/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 阅读快速开始

需要团队接入支持？

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们