Google

Imagen 4

imagen-4.0

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 ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

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

Preise

imagen-4.0 per image

Einzelpreis	$0.060

Positionsübersicht

imagen-4.0 ist das Standardmodell der Imagen-4-Reihe für Text-zu-Bild und akzeptiert ausschließlich Text-Prompts. Es eignet sich für alltägliche Generierungsanforderungen, bei denen ein Gleichgewicht zwischen Bildqualität und Generierungskosten gefragt ist. Es unterstützt Prompts mit bis zu 5000 Zeichen sowie negative Prompts mit bis zu 500 Zeichen, lässt sich ein Seitenverhältnis aus 1:1, 16:9, 9:16, 3:4, 4:3 und auto angeben und kann per seed dieselbe Konfiguration reproduzierbar machen. Im Vergleich zur Fast-Version eignet es sich besser für die Batch-Generierung, die eine stabile Ergebnisqualität erfordert, aber keine extremen Details anstrebt; Entwickler können es über die einheitliche Schnittstelle von HiAPI.ai aufrufen und so in ihre eigene Generierungspipeline einbinden.

Zentrale Highlights

Gezielte Verbesserungen bei der Textdarstellung im Bild – Untersuchungen zeigen, dass diese Reihe bei der Textgenerierung innerhalb von Bildern deutlich besser abschneidet als die Vorgängergeneration, was sie für Designentwürfe mit lesbarem Text im Bild geeignet macht.
Unterstützung von negativen Prompts und seed-Reproduzierbarkeit – Mit negative_prompt lassen sich unerwünschte Elemente ausschließen, und mit seed lässt sich dieselbe Generierungskonfiguration fest reproduzieren, was Iterationen und Regressionsprüfungen erleichtert.
Sechs Seitenverhältnisse direkt wählbar – aspect_ratio deckt quadratisch, Querformat, Hochformat sowie 3:4 und 4:3 ab und bietet zusätzlich auto zur automatischen Auswahl, sodass nachträgliches Zuschneiden entfällt.
Klare Positionierung als Standardstufe – Dieselbe Reihe umfasst außerdem die Stufen Fast und Ultra; die Standardversion eignet sich als Standardwahl für die alltägliche Batch-Generierung, während für höhere Ansprüche an das Endergebnis ein Upgrade möglich ist.

Funktionsbeschreibung

Text-zu-Bild-Generierung: Eine Texteingabe genügt, um ein Bild zu erhalten; das Prompt-Limit von 5000 Zeichen reicht aus, um Motiv, Stil und Komposition vergleichsweise vollständig zu beschreiben.

Parameter zur Steuerung der Generierung: negative_prompt dient dazu, auszuschließende Elemente anzugeben, seed dazu, dasselbe Ergebnis zu reproduzieren; beides zusammen macht den Generierungsprozess justierbar und nachvollziehbar.

Anpassung des Seitenverhältnisses: Das Ausgabeverhältnis lässt sich zwischen quadratisch, Querformat, Hochformat sowie 4:3 und 3:4 wählen oder auto überlassen, das das Kompositionsverhältnis anhand des Prompt-Inhalts bestimmt.

Darstellung lesbaren Texts: Wenn im Prompt der Bildtext beschrieben wird, verarbeitet das Modell die Textdarstellung besser als die Vorgängergeneration; die endgültige Schriftform sollte jedoch weiterhin manuell geprüft werden.

Anwendungsszenarien

Social-Media-Bebilderung für Marketingteams – Das Bild wird passend zum Kampagnenthema per Text beschrieben, ein Quer- oder Hochformat gewählt und die Bebilderung in Serie erzeugt, um sie direkt in den Content-Kanälen auszuspielen.
Poster und Präsentationsskizzen für Designer – Mit Prompts, die Titeltexte enthalten, lassen sich Poster oder Cover-Entwürfe mit Text generieren, die als visuelle Richtungsreferenz vor dem Layouten dienen.
Produktkonzeptbilder mit festem Stil – Mit festem seed und Seitenverhältnis wird der Prompt rund um dasselbe Produkt wiederholt feinjustiert, um stilistisch konsistente Konzeptbilder für die Konzeptprüfung zu erzeugen.
Automatisierte Einbindung in Generierungsprozesse – Die Text-zu-Bild-Generierung wird als Schritt in eine Pipeline eingebunden, in der Programme Prompt und Verhältnisparameter übergeben, Material in Serie erzeugen und der nachgelagerten Prüfung zuführen.

Einschränkungen und Auswahlhinweise

Die Eingabe unterstützt ausschließlich Text; eine Bearbeitung oder partielle Neugestaltung auf Basis vorhandener Bilder ist nicht möglich. An Parametern stehen nur Prompt, negativer Prompt, Seitenverhältnis und seed zur Verfügung, es gibt keine feineren Steuerungsoptionen wie Schritte oder Stilintensität. Obwohl Text im Bild gegenüber der Vorgängergeneration verbessert wurde, empfiehlt es sich, ihn vor der Auslieferung Bild für Bild zu prüfen. Wer eine stärkere Prompt-Befolgung und mehr Detailtreue benötigt, kann die Ultra-Stufe derselben Reihe in Betracht ziehen; wer mehr Wert auf Generierungsgeschwindigkeit legt, kann die Fast-Stufe wählen. Dieses Modell eignet sich nicht für Szenarien, die Bildeingaben oder feine lokale Steuerung erfordern.

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

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

seedstringOptionalmaxLength 500

Optionaler Zufallsseed für die Reproduzierbarkeit der generierten Ergebnisse; wird als Zeichenkette übergeben.

promptstringPflichtminLength 1maxLength 5000

Textbeschreibung des zu generierenden Bildes; dies ist die Haupteingabe für die Bilderzeugung.

aspect_ratiostringPflicht

Steuert das Seitenverhältnis des Ausgabebildes; wird als Zeichenkette angegeben.

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

negative_promptstringOptionalmaxLength 5000

Beschreibt Elemente, die aus dem generierten Bild ausgeschlossen werden sollen; wird als Text übergeben.

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",
  "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",
    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",
        "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"
    }
  }
}