在 Hermes Agent 中使用 Ideogram V3。
Ideogram V3 生成的图像具有行业领先的文本渲染能力 — 在海报、logo 和标识上呈现其他图像模型难以胜任的可读排版。它提供三个端点（text_to_image、edit_image、remix_image）和一个 turbo 速度层级，能以更低成本将生成时间缩短一半。Hermes Agent 通过用于聊天的同一个 RunAPI 自定义 provider 和 API 密钥调用它，无需安装额外插件。
使用 RunAPI 通过 Ideogram V3 生成带准确文本渲染的图像。
要求：
- 使用 RunAPI 的 API https://runapi.ai/v1/text_to_image。
- 从 RUNAPI_API_KEY 环境变量读取 API 密钥。
- 使用 Hermes Agent 中已配置的 custom:runapi provider。
- 将 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"
}
三步在 Hermes Agent 中使用 Ideogram V3
Configure RunAPI
Set the RUNAPI_API_KEY environment variable in your shell profile. If the custom:runapi provider is already configured in Hermes Agent 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. |
Hermes Agent 上的 Ideogram V3 是什么？
Ideogram V3 是适合商业工作的实用设计工具，产出干净、商业可用的图像。它支持编辑、混合创作和 Turbo 速度档，可按任务平衡成本与质量。Hermes Agent 通过 RunAPI custom provider 调用它。
Ideogram V3 使用场景
客户交付物的商业设计
生成可直接用于客户交付的专业设计——横幅、封面图和营销素材——无需在风格过于艺术化的输出上进行大量手工调整。
带文字叠加的社交媒体内容
批量生成 Instagram、LinkedIn 或 Twitter 的帖子视觉内容，附有精准的文字叠加，Ideogram 的高文字准确率确保一次成功。
多格式品牌套件
在 Hermes Agent 工作流中为同一品牌资产生成多种格式——横版、竖版、正方形——用 Ideogram 的混合创作模式保持跨格式的视觉一致性。
Ideogram V3 + Hermes Agent 常见问题
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.
Add a custom provider with base_url https://runapi.ai/v1 and your RUNAPI_API_KEY in the Hermes Agent provider config. Once configured, call any RunAPI endpoint — text_to_image, edit_image, remix_image — through the same provider. Run hermes doctor to verify the connection.
Yes. Use the remix_image endpoint with model set to ideogram-v3-remix. Pass source_image_url with the style reference image, then describe the new composition in the prompt. The output inherits the visual style of the source while following the text prompt for content. You can also set style to design, realistic, or general to further guide the output.
Hermes Agent passes your prompt (including text content and placement instructions) to the RunAPI Ideogram V3 endpoint. The model handles text rendering natively. For best results, clearly specify the text to render and its position in the prompt.
For text-heavy designs -- logos, posters, signage -- Ideogram V3 saves significant time over alternatives that require manual text correction. The turbo tier cuts cost in half versus balanced mode while using the same model. For images without text, other models like Flux 2 or Imagen 4 may offer better value.
立即在 Hermes Agent 中试用 Ideogram V3。
免费获取 RunAPI 密钥，配置 custom:runapi provider，即可使用 Ideogram V3 生成具有准确排版的图像。