Wie verwende ich die Krea 3 API? In 5 Minuten zum ersten Bild

TL;DR

• Krea 3 (krea-3/text-to-image) ist ein Text-zu-Bild-Modell: Eine Beschreibung erzeugt realistische Fotografie, Illustrationen und Concept Art. Vor der Bildgenerierung werden Prompts verstanden und erweitert. Zwei Varianten berry (Qualität priorisiert, Standard) / jam (Geschwindigkeit priorisiert) sind zum gleichen Preis umschaltbar. Öffne die Modellseite und probiere es aus – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Der Preis wird pro Bild berechnet: Krea 3 $0.036; aus derselben Familie gibt es das günstigere Krea 2 Medium Turbo (krea-2-medium-turbo) für $0.0215 (vollständige Preistabelle auf der Preisseite).
• Aufruf über die HiAPI-/v1/tasks-Schnittstelle: Aufgabe übermitteln und taskId erhalten, dann das Ergebnis abfragen, nach Erfolg das Bild von output[0].url herunterladen.

Was es kann

• Selbst ein einzelner Prompt erzeugt ein vollständiges Bild: Das Modell führt vor der Bildgenerierung eine Inferenz-Erweiterung durch; auch a lighthouse allein ergänzt Tageszeit, Licht und Komposition. Bei konkreter Formulierung folgt es deiner Beschreibung.
• berry / jam – zwei Varianten, eine ID: Umschalten über variant, Parameter und Preis völlig identisch; bei gleichem Seed unterscheiden sich Komposition und Farbton, du kannst beide einmal laufen lassen und als zwei Entwürfe vergleichen.
• 6 Größen-Presets bis 1K: Quadrat, Hochformat, Querformat – insgesamt 6 (1024×1024 bis 1024×576), Ausgabe als PNG oder JPEG.
• Auch Poster mit Titeltext: Text in Anführungszeichen setzen, kurze Titel sind meist korrekt.

Das folgende Bild ist ein echtes Ergebnis von berry:

Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look

(Auf Deutsch: Studio-Produktfotografie: Parfümflasche aus satiniertem Glas mit gebürstetem Messingverschluss auf einem Block Travertin, hartes Nachmittagslicht wirft den langen Schatten eines Palmblatts auf eine warme beige Wand, klare Reflexionen, hochwertige Magazin-Optik. Größe: Standard square_hd.)

krea-3/text-to-image, berry, square_hd, 1024×1024, $0.036.

Mit diesem Prompt generieren →

Wie man die beiden Modelle wählt

	krea-3/text-to-image (Krea 3)	krea-2-medium-turbo (Krea 2 Medium Turbo)
Pro Bild	$0.036	$0.0215
Größe	6 Presets (max. 1024×1024), keine benutzerdefinierten Größen	aspect_ratio mit 8 Seitenverhältnissen, inkl. 2.35:1 Cinemascope
Besondere Parameter	variant (berry/jam), reasoning_level (Inferenz-Erweiterung), negative_prompt (nur berry)	creativity mit 4 Stufen (raw/low/medium/high)
Prompt-Verarbeitung	Inferenz-Erweiterung vor der Bildgenerierung, auch kurze Sätze ergeben ein vollständiges Bild	Direkte Ausgabe nach Originaltext, so detailliert wie geschrieben
Geeignet für	Finale Bilder, schnelles Erkunden mit kurzen Prompts, Poster mit Text	Massenproduktion, breite Kompositionen, budgetbewusste tägliche Produktion

Beide Modelle lassen sich kombinieren: Krea 2 für Entwürfe zur Richtungsfindung, Krea 3 für das Finale – ein Entwurf plus ein finales Bild kosten $0.0575. Szenariobezogene Prompt-Vorlagen findest du in der Prompt-Sammlung.

Zwei Wege zum Einstieg

Browser in 3 Schritten: Modellseite öffnen → Prompt einfügen, Größe wählen → Generieren klicken, ein Bild kostet $0.036.

API in 3 Schritten: POST /v1/tasks übermitteln → taskId erhalten → mit GET /v1/tasks/<taskId> abfragen und nach success herunterladen.

curl: Das erste Bild

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "krea-3/text-to-image",
  "input": {
    "prompt": "Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look",
    "image_size": "square_hd",
    "variant": "berry",
    "reasoning_level": "medium"
  }
}'

Für Krea 2 Medium Turbo nur model und die input-Felder ändern:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "krea-2-medium-turbo",
  "input": {
    "prompt": "Futuristic city skyline at dusk, neon reflections on wet streets, cinematic widescreen",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}'

Die zurückgegebene taskId ist der Abfragebeleg.

Python: Übermitteln, Polling, Herunterladen

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "krea-3/text-to-image",
    "input": {
        "prompt": "Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look",
        "image_size": "square_hd",
        "variant": "berry",
        "reasoning_level": "medium",
    },
}

# Übermitteln: mit Idempotency-Key, Netzwerk-Retries erstellen keine doppelten Aufgaben
resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

# Polling: queued -> handling -> archiving -> success / fail
while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(3)

if task["status"] == "success":
    image_url = task["output"][0]["url"]   # temporäre Adresse, sofort herunterladen und speichern
    img = requests.get(image_url, timeout=60)
    with open("output_image", "wb") as f:  # Dateiendung entsprechend dem tatsächlich zurückgegebenen Format benennen
        f.write(img.content)
    print("saved")

Parametertabelle (krea-3/text-to-image)

Feld	Erforderlich	Werte	Beschreibung
prompt	Ja	1–5000 Zeichen	Bildbeschreibung; je konkreter, desto mehr folgt es der Beschreibung
image_size	Nein	square_hd / square / portrait_4_3 / portrait_16_9 / landscape_4_3 / landscape_16_9, Standard square_hd	Größen-Preset, max. 1024×1024; kein auto und keine benutzerdefinierten Breiten/Höhen
variant	Nein	berry / jam, Standard berry	berry priorisiert Qualität, jam priorisiert Geschwindigkeit; gleicher Preis
reasoning_level	Nein	low / medium, Standard medium	Umfang der Prompt-Inferenz-Erweiterung; medium für kurze Prompts, low bei konkreter Formulierung
negative_prompt	Nein	≤1024 Zeichen	Inhalte, die nicht erscheinen sollen; nur bei berry wirksam
output_format	Nein	png / jpeg, Standard png	Ausgabeformat
seed	Nein	Ganzzahl 0–2147483647	Reproduzierbar innerhalb derselben Variante; berry und jam reproduzieren sich gegenseitig nicht

Krea 2 Medium Turbo hat andere Felder: prompt (erforderlich), aspect_ratio (8 Optionen, Standard 1:1), creativity (raw/low/medium/high, Standard low), seed. Felder außerhalb der Tabelle im Request-Body führen direkt zu 400.

Fehler, die dir begegnen werden (Original-Schnittstellenmeldungen)

Was du getan hast	Rückgabe
image_size mit auto übergeben	400 invalid input: image_size: value must be one of 'square_hd', 'square', 'portrait_4_3', 'portrait_16_9', 'landscape_4_3', 'landscape_16_9'
Feld außerhalb der Tabelle übergeben (z. B. num_images)	400 invalid input: <root>: additional properties 'num_images' not allowed
prompt ist leer	400 invalid input: prompt: minLength: got 0, want 1
variant falsch geschrieben	400 invalid input: variant: value must be one of 'berry', 'jam'
Guthaben unzureichend	402 insufficient account balance; top up and retry

Anfragen, die die Parametervalidierung nicht bestehen, werden nicht berechnet. Bei wiederholter Übermittlung mit demselben Idempotency-Key wird 409 (in Bearbeitung) oder 422 (Parameter inkonsistent) zurückgegeben; versuche es mit einem neuen Key erneut.

Vor dem Go-live beachten

• Callback: Übergib auf oberster Ebene des Request-Bodys "callback": {"url": "https://..."}; beim Erreichen des Endzustands wird dein Dienst benachrichtigt, was Polling spart.
• Rechtzeitig sichern: output[0].url ist eine temporäre Adresse; sobald erhalten, herunterladen und im eigenen Speicher ablegen.
• Nur 6 Größen: Für 2.35:1 Cinemascope oder weitere Seitenverhältnisse nutze aspect_ratio von Krea 2 Medium Turbo.
• Seed ist nur innerhalb einer Variante reproduzierbar: berry und jam ergeben mit demselben Seed unterschiedliche Bilder; für Serienbilder variant + seed fixieren.

Häufige Fragen

Funktionieren auch kurze Prompts?

Ja. Das Modell führt eine Inferenz-Erweiterung durch; a lighthouse allein ergibt ein vollständiges Bild. Wenn du Details steuern willst, formuliere den Prompt konkreter.

Unterscheiden sich berry und jam nur in der Geschwindigkeit?

Nicht nur. Bei gleichem Seed unterscheiden sich Komposition und Farbton, die Bildqualität ist vergleichbar; behandle sie als zwei Entwürfe und vergleiche sie.

Wirkt negative_prompt bei beiden Varianten?

Nur bei berry; bei jam übergeben hat es keine Wirkung.

Wie viele Bilder auf einmal?

Pro Aufruf nur 1 Bild. Für mehrere Bilder weitere Aufgaben übermitteln oder mit anderem Seed erneut laufen lassen.

Wie viele Bilder gibt es für $10?

Krea 3 kostet $0.036 pro Bild, also etwa 277 Bilder. Neue Nutzer erhalten bei der Registrierung 200 Credits (1 USD = 2.000 Credits).

Nächster Schritt: Nimm den Parfümflaschen-Prompt und probiere ein Bild auf der Modellseite aus und kopiere dann szenariobezogene Vorlagen aus der Prompt-Sammlung.