Gebruik Ideogram V3 in Hermes Agent.
Ideogram V3 genereert afbeeldingen met toonaangevende tekstweergave — leesbare typografie op posters, logo's en borden waar andere beeldmodellen moeite mee hebben. Het biedt drie endpoints (text_to_image, edit_image, remix_image) en een turbo-snelheidsniveau dat de generatietijd halveert tegen lagere kosten. Hermes Agent roept het aan via dezelfde RunAPI aangepaste provider en API-sleutel die voor chat worden gebruikt, zonder extra plug-ins te installeren.
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"
}
Gebruik Ideogram V3 in Hermes Agent in drie stappen
Configureer RunAPI
Stel de omgevingsvariabele RUNAPI_API_KEY in in je shellprofiel. Als de custom:runapi-provider al is geconfigureerd in Hermes Agent voor chat, werkt dezelfde sleutel voor Ideogram V3 — geen extra configuratie nodig.
export RUNAPI_API_KEY=runapi_xxx
Roep Ideogram V3 aan
Stuur een POST-verzoek naar het text_to_image-endpoint met model ingesteld op ideogram-v3-text-to-image. Voeg je prompt toe met tekst die je in de afbeelding wilt weergeven. Stel style in op design voor poster- en logowerk, of realistic voor fotografische uitvoer. Gebruik rendering_speed turbo voor snellere resultaten tegen lagere kosten.
POST /v1/text_to_image
Haal het resultaat op
De API retourneert onmiddellijk een task_id. Poll het taakstatusendpoint totdat de status verandert naar voltooid, haal dan de uitvoerafbeeldings-URL op uit de reactie. Vraag tot 4 afbeeldingen per aanroep aan met output_count.
task_id: tsk_abc123
Ideogram V3 API-parameters
| Parameter | Type | Beschrijving |
|---|---|---|
model |
string |
Verplicht. ideogram-v3-text-to-image, ideogram-v3-edit of ideogram-v3-remix. |
prompt |
string |
Tekstbeschrijving van de gewenste afbeelding. Vermeld specifieke tekst die je wilt weergeven. |
style |
string |
Optioneel. auto, general, realistic of design. Gebruik design voor posters en logo's. |
rendering_speed |
string |
Optioneel. turbo (snelst, laagste kosten), balanced (standaard) of quality (meeste detail). |
aspect_ratio |
string |
Optioneel. 1:1, 3:4, 9:16, 4:3 of 16:9. |
output_count |
integer |
Optioneel. Aantal te genereren afbeeldingen per verzoek. 1 tot 4. |
source_image_url |
string |
Verplicht voor edit- en remix-endpoints. URL van de bronafbeelding. |
Wat is Ideogram V3 in Hermes Agent?
Ideogram V3 is het praktische ontwerptool dat gebruikers het "sweet spot" noemen voor typografie-nauwkeurigheid en visuele kwaliteit. Hermes Agent roept het aan via de RunAPI custom provider voor ontwerptaken in geautomatiseerde workflows.
Ideogram V3-toepassingen
T-shirt- en merchandiseontwerp
Genereer drukklare merchandiseontwerpen met slogans, citaten en grafische tekstelementen.
Batchproductie van marketingmateriaal
Maak sets marketingmateriaal — posters, sociale kaarten, banners — met consistente merkstijl.
Icoon- en infographicdesign
Genereer iconsets en data-rijke infographics waarbij elke tekstelement nauwkeurig is.
Vragen over Ideogram V3 + Hermes Agent
Ideogram V3 is specifiek geoptimaliseerd voor typografieweergave. Het kan leesbare meerregelige tekst, gestileerde koppen en logo-kwaliteit lettering produceren die modellen als Flux of Imagen vaak vervormen. Als je gebruikssituatie nauwkeurige tekst op posters, borden of productlabels vereist, is Ideogram V3 de sterkste optie in de RunAPI-catalogus.
Turbo genereert het snelst tegen ongeveer de helft van de kosten van balanced. Quality produceert de meest gedetailleerde uitvoer maar duurt langer. Balanced is het standaard midden. Alle drie de niveaus gebruiken hetzelfde onderliggende Ideogram V3-model — het verschil zit in rekentijd en beeldkwaliteit, niet de modelversie.
Voeg een aangepaste provider toe met base_url https://runapi.ai/v1 en je RUNAPI_API_KEY in de Hermes Agent-providerconfiguratie. Na configuratie kun je elk RunAPI-endpoint aanroepen — text_to_image, edit_image, remix_image — via dezelfde provider. Voer hermes doctor uit om de verbinding te verifiëren.
Ja. Gebruik het remix_image-endpoint met model ingesteld op ideogram-v3-remix. Geef source_image_url mee met de stijlreferentieafbeelding en beschrijf de nieuwe compositie in de prompt. De uitvoer erft de visuele stijl van de bron terwijl de tekstprompt voor inhoud wordt gevolgd. Je kunt ook style instellen op design, realistic of general om de uitvoer verder te sturen.
Elke gegenereerde afbeelding wordt apart gefactureerd. Als je output_count op 4 instelt, worden 4 afbeeldingen in rekening gebracht. Het tarief per afbeelding hangt af van je rendering_speed-instelling — turbo kost ongeveer de helft van balanced. Controleer de RunAPI-prijspagina voor actuele tarieven. Mislukte generaties worden niet in rekening gebracht.
Algemene Hermes Agent-configuratie
Nog niet geconfigureerd? Begin met de RunAPI-configuratiegids voor Hermes Agent.
Hermes Agent-configuratiegids →Ideogram V3-modelcatalogus
Bekijk alle Ideogram V3-varianten, prijzen en API-documentatie.
Ideogram V3-modellen →Probeer Ideogram V3 in Hermes Agent vandaag.
Haal een gratis RunAPI-sleutel, configureer de custom:runapi-provider en begin afbeeldingen te genereren met nauwkeurige typografie via Ideogram V3.