Google

Imagen 4

imagen-4.0-ultra

Google-Reihe für Text-zu-Bild, spezialisiert auf Textdarstellung im Bild und komplexe Beleuchtung, mit drei Stufen Fast, Standard und Ultra je nach Abwägung zwischen Qualität und Kosten

imagen-4.0 imagen-4.0-fast imagen-4.0-ultra

imagen-4.0-ultra ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

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

Preise

imagen-4.0-ultra per image

Einzelpreis	$0.090

Einordnung und Kurzprofil

imagen-4.0-ultra ist das Text-zu-Bild-Modell der Imagen-4-Familie für hochpräzise Ausgaben und eignet sich für Generierungsaufgaben, die exakte Prompt-Befolgung, komplexe Szenenkompositionen und klaren Text im Bild erfordern. Entwickler erzeugen Bilder über die einheitliche Schnittstelle von HiAPI.ai aus Text-Prompts und können dabei ein Seitenverhältnis von 1:1, 16:9, 9:16, 3:4, 4:3 oder auto wählen; die Wahl empfiehlt sich für die finale Ausgabe von Markenvisuals, Designentwürfen und Konzeptbildern.

Zentrale Highlights

Stärkere Prompt-Befolgung und schärfere Details – Als Ultra-Version richtet sich das Modell stärker an Text-Prompts aus und liefert Ergebnisse, die näher an der Beschreibung liegen; ideal für die Erzeugung von Bildern in Produktionsqualität.
Verbesserte Textwiedergabe im Bild – Im Vergleich zur Vorgängergeneration deutlich verbessert bei der Erzeugung von Text im Bild; Inhalte wie Poster und Beschilderungen sind besser nutzbar.
Direkte Ausgabe im gewünschten Seitenverhältnis – Das Pflichtfeld aspect_ratio unterstützt 1:1, 16:9, 9:16, 3:4, 4:3 und auto, sodass sich Formate ohne nachträgliches Zuschneiden an die Platzierung anpassen lassen.

Funktionsumfang

Hochpräzise Text-zu-Bild-Generierung: Erzeugt fotorealistische Bilder aus Text-Prompts und eignet sich für professionelle Marken- und Designausgaben; Prompts haben eine Längenbegrenzung, die vollständige Absicht muss also innerhalb der verfügbaren Zeichenzahl ausgedrückt werden.

Komplexe Komposition und Lichtwirkung: Unterstützt Generierungsanforderungen mit komplexen Szenenkompositionen und komplexer Beleuchtung, reduziert mehrere Wiederholungsversuche und nutzt einen Aufruf für ein brauchbares Bild.

Steuerung des Seitenverhältnisses: Über das Pflichtfeld aspect_ratio wird das Ausgabeverhältnis festgelegt, einschließlich quadratischer, Quer-, Hochformat- sowie 3:4- und 4:3-Formate, passend zu den Materialvorgaben verschiedener Kanäle.

Einschränkung durch negative Prompts: Das optionale negative_prompt beschreibt Elemente, die vermieden werden sollen, um den Bildinhalt zu steuern und die Wahrscheinlichkeit unerwünschter Elemente zu verringern.

Reproduzierbare Generierung: Der optionale Parameter seed ermöglicht reproduzierbare Ergebnisse und erleichtert es, Resultate beim Debugging und in der Stapelproduktion festzuhalten und die Wirkung verschiedener Prompts zu vergleichen.

Anwendungsfälle

Marken- und Marketingteams: Produktbotschaften – Markenton und Verkaufsargumente eingeben und hochpräzise visuelle Materialien erzeugen, die direkt für Werbeplatzierungen und Social-Media-Kanäle nutzbar sind.
Designteams: Textbedarf für Poster und Präsentationen – Ein Layout mit Titeltext beschreiben und einen Entwurf mit verhältnismäßig klarem Text im Bild erzeugen, der als Designreferenz und Iterationsgrundlage für Poster und Präsentationsmaterialien dient.
Konzeptdesign: Beschreibung komplexer Kompositionen und Lichtsituationen – Szene, Kameraführung und Lichtanforderungen eingeben und hochpräzise Konzeptbilder erzeugen, die der visuellen Ausrichtung in der Frühphase und der Präsentation von Konzepten dienen.
Entwicklungsteams: Stapelverarbeitung zur Bilderzeugung – Mit festem seed und festen Verhältnisparametern in Stapeln aufrufen und stilistisch einheitliche Fertigbilder erzeugen, die in Content-Produktion oder Materialverwaltung eingebunden werden.

Einschränkungen und Auswahlempfehlungen

Es wird ausschließlich Texteingabe akzeptiert; Bildbearbeitung per Bildeingabe wird nicht unterstützt. Die Prompt-Länge unterliegt der Obergrenze des Schemas, überlange Beschreibungen müssen gekürzt werden. Die Textwiedergabe im Bild ist zwar verbessert, sollte aber vor der Veröffentlichung dennoch manuell geprüft werden. Die Kosten pro Bild liegen bei der Ultra-Version höher als bei anderen Versionen derselben Familie; für große Mengen an Entwürfen empfiehlt es sich, zunächst mit der Standard- oder Fast-Version vorzufiltern und erst dann mit diesem Modell die Fertigbilder auszugeben. Wenn Bildbearbeitung oder Bild-zu-Bild-Funktionen benötigt werden, sollte ein anderes Modell gewählt werden.

Neuigkeiten

Changelog ansehen →

Feature-Änderung Imagen 4 Modell-IDs geändert zu imagen-4.0… Oct 21, 2026
Neues Modell Neue Dokumentation zur Bildgenerierung mit Google Imagen 4 Oct 14, 2026

Häufige Fragen

Alle Fragen ansehen →

Wofür eignet sich Imagen 4?

Für alltägliche Produkt-, Lifestyle- und Inhaltsbilder. Wenn Sie Motiv, Szene, Material und Licht klar beschreiben, erhalten Sie bilder, die sich für die Begutachtung eignen – häufig verwendet für Produkthauptbilder, Entwürfe für Markenkampagnen und Artikelbebilderung.
Welche Seitenverhältnisse unterstützt Imagen 4?

6 werden unterstützt: 1:1, 16:9, 9:16, 3:4, 4:3 und auto. aspect_ratio ist erforderlich, der Playground auf dieser Seite verwendet standardmäßig 16:9.
Wie lang darf ein Prompt höchstens sein?

Maximal 5.000 Zeichen. prompt ist erforderlich; es empfiehlt sich, die Angaben in der Reihenfolge Motiv, Szene, Material, Licht und Text zu strukturieren.
Können unerwünschte Elemente ausgeschlossen werden?

Ja, mit negative_prompt. Es ist ein optionaler Parameter mit einer maximalen Länge von 5.000 Zeichen und eignet sich zum Ausschließen von überflüssigem Text, Wasserzeichen oder unruhigem Hintergrund.

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: imagen-4.0-ultra

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für imagen-4.0-ultra und Route default — siehe Parametertabelle unten.

seedstringOptionalmaxLength 500

Optionales zufälliges Seed, als Zeichenkette; die Übergabe desselben Seeds ermöglicht bei gleicher Eingabe die Reproduktion des Generierungsergebnisses.

promptstringPflichtminLength 1maxLength 5000

Textbeschreibung des zu generierenden Bildes, Zeichenkette, zur Festlegung des Bildinhalts.

aspect_ratiostringPflicht

Seitenverhältnis des Ausgabebildes, Zeichenkette, erforderlich.

Optionen:1:116:99:163:44:3auto

negative_promptstringOptionalmaxLength 5000

Optionaler negativer Prompt, Zeichenkette, zur Beschreibung von Elementen, die im generierten Bild vermieden werden sollen.

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": "imagen-4.0-ultra",
  "input": {
    "prompt": "…",
    "aspect_ratio": "…"
  }
}'

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: "imagen-4.0-ultra",
    input: {
      "prompt": "…",
      "aspect_ratio": "…"
    }
  }),
});
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": "imagen-4.0-ultra",
        "input": {
          "prompt": "…",
          "aspect_ratio": "…"
        }
    },
)
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"
    }
  }
}