---
title: "Ideogram V3 in Hermes Agent über RunAPI verwenden — Bild-API-Anleitung"
url: "https://runapi.ai/de/hermes-ideogram-v3.md"
canonical: "https://runapi.ai/de/hermes-ideogram-v3"
locale: "de"
model: "ideogram-v3"
---

# Ideogram V3 in Hermes Agent verwenden.

Ideogram V3 generiert Bilder mit branchenführendem Textrendering — lesbare Typografie auf Postern, Logos und Schildern, mit der andere Bildmodelle Schwierigkeiten haben. Es bietet drei Endpunkte (text_to_image, edit_image, remix_image) und eine Turbo-Geschwindigkeitsstufe, die die Generierungszeit bei reduzierten Kosten halbiert. Hermes Agent ruft es über denselben RunAPI custom Provider und API-Key auf, der für Chat verwendet wird — keine zusätzlichen Plugins zu installieren.

## 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. **RunAPI konfigurieren** — Die Umgebungsvariable RUNAPI_API_KEY in der Shell-Konfiguration setzen. Wenn der custom:runapi Provider bereits in Hermes Agent für Chat konfiguriert ist, funktioniert derselbe Key für Ideogram V3 — kein zusätzliches Setup erforderlich.
2. **Ideogram V3 aufrufen** — Eine POST-Anfrage an den text_to_image-Endpunkt senden, model auf ideogram-v3-text-to-image setzen. Den Prompt mit dem gewünschten Text im Bild angeben. style auf design für Poster und Logo-Arbeit oder realistic für fotografische Ausgabe setzen. rendering_speed turbo für schnellere Ergebnisse zu geringeren Kosten verwenden.
3. **Ergebnis abrufen** — Die API gibt sofort eine task_id zurück. Den Task-Status-Endpunkt abfragen, bis der Status auf completed wechselt, dann die Ausgabe-Bild-URL aus der Antwort abrufen. Bis zu 4 Bilder pro Aufruf mit output_count anfordern.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. ideogram-v3-text-to-image, ideogram-v3-edit oder ideogram-v3-remix. |
| `prompt` | `string` | Textbeschreibung des gewünschten Bildes. Den gewünschten Text im Bild angeben. |
| `style` | `string` | Optional. auto, general, realistic oder design. design für Poster und Logos verwenden. |
| `rendering_speed` | `string` | Optional. turbo (schnellste, günstigste), balanced (Standard) oder quality (höchste Detailschärfe). |
| `aspect_ratio` | `string` | Optional. 1:1, 3:4, 9:16, 4:3 oder 16:9. |
| `output_count` | `integer` | Optional. Anzahl der Bilder pro Anfrage. 1 bis 4. |
| `source_image_url` | `string` | Erforderlich für Edit- und Remix-Endpunkte. URL des Quellbildes. |

## FAQ

### Wie verarbeitet Ideogram V3 Text in Bildern im Vergleich zu anderen Modellen?

Ideogram V3 ist speziell für Typografie-Rendering optimiert. Es kann lesbaren mehrzeiligen Text, stilisierte Überschriften und Logo-qualitative Schrift erzeugen, die Modelle wie Flux oder Imagen oft verzerren. Für Anwendungsfälle mit präzisem Text auf Postern, Schildern oder Produktetiketten ist Ideogram V3 die stärkste Option im RunAPI-Katalog.

### Was ist der Unterschied zwischen turbo, balanced und quality als Rendering-Geschwindigkeiten?

Turbo generiert am schnellsten zu etwa der Hälfte der Kosten von balanced. Quality liefert die detailreichste Ausgabe, braucht aber länger. Balanced ist die standardmäßige Mittelstufe. Alle drei Stufen verwenden dasselbe Ideogram V3-Modell — der Unterschied liegt in Rechenzeit und Wiedergabetreue, nicht in der Modellversion.

### Wie konfiguriere ich den custom:runapi Provider in Hermes Agent für Ideogram V3?

Den custom:runapi Provider mit base_url https://runapi.ai/v1 und dem RUNAPI_API_KEY in der Hermes Agent Provider-Konfiguration hinzufügen. Danach jeden RunAPI-Endpunkt — text_to_image, edit_image, remix_image — über denselben Provider aufrufen. hermes doctor ausführen, um die Verbindung zu überprüfen.

### Kann ich den Remix-Modus verwenden, um den Stil eines Bildes auf ein anderes zu übertragen?

Ja. Den remix_image-Endpunkt mit model ideogram-v3-remix verwenden. source_image_url mit dem Stilreferenzbild übergeben, dann die neue Komposition im Prompt beschreiben. Die Ausgabe übernimmt den visuellen Stil der Quelle und folgt dem Textprompt für den Inhalt. style kann zusätzlich auf design, realistic oder general gesetzt werden.

### Wie funktioniert die Preisgestaltung pro Bild mit output_count?

Jedes generierte Bild wird separat abgerechnet. Bei output_count 4 werden 4 Bilder berechnet. Der Preis pro Bild hängt von der rendering_speed-Einstellung ab — turbo kostet etwa die Hälfte von balanced. Aktuelle Preise auf der RunAPI-Preisseite ansehen. Fehlgeschlagene Generierungen werden nicht berechnet.


## Links

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