Use Ideogram V3 in Hermes Agent.
Ideogram V3 generates images with industry-leading text rendering — readable typography on posters, logos, and signage that other image models struggle with. It offers three endpoints (text_to_image, edit_image, remix_image) and a turbo speed tier that cuts generation time in half at reduced cost. Hermes Agent calls it through the same RunAPI custom provider and API key used for chat, with no extra plugins to install.
Use RunAPI to generate an image with accurate text rendering using Ideogram V3.
Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Use the custom:runapi provider already configured in Hermes Agent.
- Set the model to "ideogram-v3-text-to-image".
- Write a prompt that includes specific text you want rendered in the image.
- Optionally set rendering_speed to turbo for faster generation, or quality for best results.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output 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"
}
Use Ideogram V3 in Hermes Agent in three steps
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 parameters
| Parameter | Type | Description |
|---|---|---|
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. |
What is Ideogram V3 on Hermes Agent?
Ideogram V3 is the practical design tool that users describe as the "sweet spot" for commercial work -- it produces clean, commercial-viable images where other models produce "gallery worthy" output that does not work for actual client deliverables. It supports edit, remix, and turbo speed tiers so you can balance cost and quality per task. Hermes Agent calls it through the RunAPI custom provider.
Ideogram V3 use cases
T-shirt and merchandise design
Generate print-ready merchandise designs with slogans, quotes, or brand names rendered as clean text -- freelancers report using it for direct-to-client deliverables.
Marketing material batch production
Create sets of marketing materials -- posters, social cards, event invitations, infographics -- using the turbo tier for draft rounds and quality tier for final outputs.
Icon and infographic design
Generate icon sets and data-rich infographics where each text label, number, and legend item renders correctly without manual correction.
Ideogram V3 + Hermes Agent questions
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 general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Ideogram V3 in Hermes Agent today.
Get a free RunAPI key, configure the custom:runapi provider, and start generating images with accurate typography using Ideogram V3.