在 OpenClaw 中使用 Ideogram V3。
Ideogram V3 生成的图像具有行业领先的文本渲染能力 — 在海报、logo 和标识上呈现其他图像模型难以胜任的可读排版。它提供三个端点（text_to_image、edit_image、remix_image）和一个 turbo 速度层级，能以更低成本将生成时间缩短一半。OpenClaw agent 通过用于聊天的同一个 RunAPI 密钥和 /v1 端点调用它，无需安装额外 skills。
使用 RunAPI 通过 Ideogram V3 生成带准确文本渲染的图像。
要求：
- 使用 RunAPI 的 API https://runapi.ai/v1/text_to_image。
- 从 RUNAPI_API_KEY 环境变量读取 API 密钥。
- 将 model 设为 "ideogram-v3-text-to-image"。
- 编写一段包含你希望在图像中渲染的具体文字的提示词。
- 可选：将 rendering_speed 设为 turbo 以加快生成，或设为 quality 以获得最佳效果。
- 响应返回一个 task_id。轮询任务状态端点直到任务完成，然后获取输出 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
Configure RunAPI
Set the RUNAPI_API_KEY environment variable in your shell profile. If RunAPI is already configured in OpenClaw for chat, the same key works for Ideogram V3 — no additional setup needed.
export RUNAPI_API_KEY=runapi_xxx
Call Ideogram V3
Send a POST request to the text_to_image endpoint with model set to ideogram-v3-text-to-image. Include your prompt with any text you want rendered in the image. Set style to design for poster and logo work, or realistic for photographic output. Use rendering_speed turbo for faster results at lower cost.
POST /v1/text_to_image
Get the result
The API returns a task_id immediately. Poll the task status endpoint until the status changes to completed, then retrieve the output image URL from the response. Request up to 4 images per call with output_count.
task_id: tsk_abc123
Ideogram V3 API 参数
| 参数 | 类型 | 说明 |
|---|---|---|
model |
string |
Required. ideogram-v3-text-to-image, ideogram-v3-edit, or ideogram-v3-remix. |
prompt |
string |
Text description of the desired image. Include specific text you want rendered. |
style |
string |
Optional. auto, general, realistic, or design. Use design for posters and logos. |
rendering_speed |
string |
Optional. turbo (fastest, lowest cost), balanced (default), or quality (highest detail). |
aspect_ratio |
string |
Optional. 1:1, 3:4, 9:16, 4:3, or 16:9. |
output_count |
integer |
Optional. Number of images to generate per request. 1 to 4. |
source_image_url |
string |
Required for edit and remix endpoints. URL of the source image. |
OpenClaw 上的 Ideogram V3 是什么？
Ideogram V3 是图像生成文字排版领域的领先模型，能精准呈现清晰专业的文字，在一两次尝试内达到 90-95% 的文字准确率，支持风格参考以保持品牌一致性。OpenClaw agent 通过与聊天相同的 RunAPI key 调用它。
Ideogram V3 使用场景
广告与营销视觉中的文字排版
生成文字清晰、整洁的社交媒体广告、横幅和推广素材，首次生成即可使用，无需多次重试才能获得可读的文字。
品牌视觉与标志设计
创作带精准文字渲染和一致视觉风格的品牌素材。使用风格参考在生成的各项素材中保持品牌识别度。
电商产品展示图
生成展示产品名称、价格或功能文字的商品图片，文字准确嵌入图像中，可直接用于列表页面，无需后期文字叠加。
Ideogram V3 + OpenClaw 常见问题
Ideogram V3 is specifically optimized for typography rendering. It can produce readable multi-line text, stylized headings, and logo-quality lettering that models like Flux or Imagen often garble. If your use case requires accurate text on posters, signs, or product labels, Ideogram V3 is the strongest option in the RunAPI catalog.
Turbo generates the fastest at roughly half the cost of balanced. Quality produces the highest-detail output but takes longer. Balanced is the default middle ground. All three tiers use the same underlying Ideogram V3 model — the difference is compute time and fidelity, not model version.
Yes. Use the edit_image endpoint with ideogram-v3-edit to modify a source image guided by a text prompt. Use the remix_image endpoint with ideogram-v3-remix to transfer the style of a source image to a new composition. Both require source_image_url as a parameter.
Each generated image is billed separately. If you set output_count to 4, you are charged for 4 images. The per-image rate depends on your rendering_speed setting — turbo costs roughly half of balanced. Check the RunAPI pricing page for current rates.
Async. The API returns a task_id immediately. Poll the task status endpoint until the task completes. RunAPI SDKs and the CLI handle polling automatically. Failed generations are not charged.
立即在 OpenClaw 中试用 Ideogram V3。
免费获取 RunAPI 密钥，将提示词粘贴到 OpenClaw 中，即可使用 Ideogram V3 生成具有准确排版的图像。