Ideogram · 图像

OpenClaw x Ideogram V3

Ideogram V3 专为图像中的排版而生，文字准确率业界领先。通过 RunAPI，所有 Ideogram V3 端点——生成、编辑和混搭——共享一把 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: 结合原图、角色参考与风格参考进行重混
  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 进入终态。

使用 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 阅读快速开始

需要团队接入支持？

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

联系我们