Ideogram

Ideogram V4

ideogram-v4

Open-Weight-Text-zu-Bild-Modell mit Fokus auf mehrsprachiges Text-Rendering und native 2K-Ausgabe, unterstützt JSON-Prompts und Layout-Steuerung über Begrenzungsrahmen

ideogram-v4

ideogram-v4 ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

ideogram-v4 per image

Spezifikationen	Einzelpreis
TURBO	$0.050
BALANCED	$0.100
QUALITY	$0.170

Positionsübersicht

ideogram-v4 ist ein Text-zu-Bild-Generierungsmodell von Ideogram, das für seine präzise Typografie innerhalb von Bildern bekannt ist und sich daher für Entwickler eignet, die klaren Text und mehrsprachige Botschaften direkt in Materialien wie Postern und Anzeigen rendern müssen. Über die einheitliche HiAPI.ai-Schnittstelle rufen Sie es mit natürlichsprachlichen Prompts und einer Render-Geschwindigkeitsstufe auf und erhalten ein Bild; es unterstützt verschiedene Seitenverhältnisse, JPEG/PNG-Ausgabe und die Reproduzierbarkeit mit festem Seed. Die Parameterstruktur ist einfach und eignet sich für Massenproduktion und Integration.

Kernhighlights

Das Rendern von Text im Bild ist der wichtigste Optimierungsbereich – im Prompt angegebener Text kann direkt als Bildinhalt gerendert werden, sodass das Layout bereits im Generierungsschritt erfolgt und nicht nachträglich überlagert werden muss.
Drei Render-Geschwindigkeitsstufen nach Bedarf umschaltbar – TURBO, BALANCED und QUALITY stehen für unterschiedliche Schwerpunkte bei Geschwindigkeit und Detailtiefe, sodass sich Aufrufe zwischen Massenentwürfen und hochwertigen Ausgaben aufteilen lassen.
Seed und Seitenverhältnis kontrollierbar, reproduzierbar und anpassbar – Unterstützt die Reproduktion von Ergebnissen mit festem seed und bietet fünf Verhältnisse (1:1, 16:9, 4:3, 9:16, 3:4), die gängige Layoutanforderungen abdecken.

Funktionsbeschreibung

Direkte Bilderzeugung mit Text aus dem Prompt: Geben Sie einen beschreibenden Prompt ein und benennen Sie den darzustellenden Text, um ein fertiges Bild mit Layout zu erhalten, wodurch das nachträgliche Überlagern von Text entfällt.

Einstellbare Render-Geschwindigkeitsstufen: Wählen Sie über rendering_speed zwischen TURBO, BALANCED und QUALITY und treffen Sie je nach Einsatzzweck eine Abwägung zwischen Geschwindigkeit und Detailtiefe.

Wählbares Seitenverhältnis und Ausgabeformat: Die Ausgabeverhältnisse decken quadratische, Quer- und Hochformate ab; die Formate JPEG und PNG lassen sich direkt auf Platzierungen abstimmen oder weiterverarbeiten.

Reproduzierbare Generierungsergebnisse mit festem Seed: Ein angegebener seed ermöglicht bei gleichen Parametern die Reproduktion desselben Ergebnisses, was den Vergleich von Prompt-Feinabstimmungen oder eine stabile Massenausgabe erleichtert.

Anwendungsfälle

Design-Teams generieren massenhaft Poster-Entwürfe mit Text – Text und Layoutbeschreibung eingeben und mit einem Aufruf ein vollständiges Bild mit Layout erhalten, das für die Vorauswahl von Entwürfen und die Bestätigung kreativer Richtungen dient.
Marketingspezialisten erstellen mehrsprachige Materialien – Zielsprachliche Texte in den Prompt schreiben und Marketingbilder generieren, die direkt für die Auslieferung oder Nachbearbeitung geeignet sind.
Entwickler integrieren eine Schnittstelle zur bedarfsgerechten Bilderzeugung – Über die einheitliche Schnittstelle Bilder im gewünschten Verhältnis und Format auf Abruf generieren und in Content-Workflows oder automatisierte Materialproduktionspipelines einbetten.

Einschränkungen und Auswahlhinweise

Das Modell deckt ausschließlich die Text-zu-Bild-Generierung ab und verfügt weder über Bildbearbeitungs- noch über Bild-zu-Bild-Fähigkeiten; für Bildänderungen oder partielle Neuzeichnungen sollten andere Modelle gewählt werden. Das Prompt-Limit ist zwar großzügig, die Layoutsteuerung hängt jedoch weiterhin von der Textbeschreibung ab, sodass komplexe Layouts wiederholte Anpassungen erfordern. Die Render-Geschwindigkeitsstufe beeinflusst Detailtiefe und Dauer der Bilderzeugung; in Massenszenarien empfiehlt es sich, die Wirkung zunächst mit einer niedrigen Stufe zu prüfen. Text, der im Bild erscheinen soll, sollte vollständig im Prompt angegeben werden, da vage Beschreibungen zu Renderabweichungen führen können.

Häufige Fragen

Alle Fragen ansehen →

Wofür eignet sich Ideogram V4 am besten?

Für Logos, Poster, Wortmarken, Verpackungen und Ladenschilder, die präzise lateinische Buchstaben erfordern.
Wie wählt man die drei Geschwindigkeitsstufen aus?

TURBO eignet sich für schnelle Entwürfe; BALANCED gleicht Geschwindigkeit und Qualität aus; QUALITY eignet sich für finale Details und komplexe Beschriftungen.
Wie unterscheiden sich die drei Preisstufen?

TURBO, BALANCED und QUALITY verwenden unterschiedliche Stufen pro Bild; die genauen Beträge richten sich nach den aktuellen Preisen auf dieser Seite.
Wie kann die Genauigkeit von Text in Bildern verbessert werden?

Schreibe den anzuzeigenden Text im Prompt wortwörtlich aus und gib Schriftstil, Hierarchie, Position und Hintergrundkontrast explizit an.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: ideogram-v4

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für ideogram-v4 und Route default — siehe Parametertabelle unten.

seedintegerOptional

Zufallsseed für reproduzierbare Generierung: Bei gleichem Seed und gleichen Parametern werden konsistente Ergebnisse erzielt; wird kein Wert übergeben, wählt der Server einen zufälligen Wert.

promptstringPflichtminLength 1maxLength 10000

Textbeschreibung des Bildinhalts. Text, der gerendert werden soll, muss hier ausdrücklich ausgeschrieben werden; präzises Layout ist die Stärke dieses Modells.

aspect_ratiostringOptionalStandard: "1:1"

Seitenverhältnis des Ausgabebilds, entspricht einer voreingestellten Größe von etwa 1 MP; Standard ist 1:1.

Optionen:1:116:94:39:163:4

output_formatstringOptionalStandard: "jpeg"

Format des Ausgabebilds; Standard ist jpeg.

Optionen:jpegpng

rendering_speedstringPflichtStandard: "BALANCED"

Stufe der Rendergeschwindigkeit: TURBO ist am schnellsten und günstigsten, QUALITY bietet die meisten Details, die Preise unterscheiden sich je nach Stufe; Standard ist BALANCED.

Optionen:TURBOBALANCEDQUALITY

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v4",
  "input": {
    "prompt": "…",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "rendering_speed": "BALANCED"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "ideogram-v4",
    input: {
      "prompt": "…",
      "aspect_ratio": "1:1",
      "output_format": "jpeg",
      "rendering_speed": "BALANCED"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "ideogram-v4",
        "input": {
          "prompt": "…",
          "aspect_ratio": "1:1",
          "output_format": "jpeg",
          "rendering_speed": "BALANCED"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}