---
title: "Gebruik Ideogram V3 in Hermes Agent via RunAPI — Afbeeldings-API-gids"
url: "https://runapi.ai/nl/hermes-ideogram-v3.md"
canonical: "https://runapi.ai/nl/hermes-ideogram-v3"
locale: "nl"
model: "ideogram-v3"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "ideogram-v3-text-to-image"
}

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Hoe gaat Ideogram V3 om met tekst in afbeeldingen vergeleken met andere modellen?

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.

### Wat is het verschil tussen turbo, balanced en quality rendersnelheden?

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.

### Hoe configureer ik de custom:runapi-provider in Hermes Agent voor Ideogram V3?

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.

### Kan ik de remix-modus gebruiken om de stijl van een afbeelding naar een andere over te dragen?

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.

### Hoe werkt de facturering per afbeelding met output_count?

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.


## Links

- [Hermes Agent-configuratiegids →](https://runapi.ai/nl/hermes-agent)
- [Ideogram V3-modellen →](https://runapi.ai/nl/models/ideogram-v3)
- [Model catalog](https://runapi.ai/nl/models)
- [API docs](https://runapi.ai/nl/docs)