# Z Image API Vollständige API-Referenz für die Z Image Text-to-Image-Generierung. ## Modellvarianten Diese API unterstützt eine Modellvariante: | Modell | ID | Beschreibung | |-------|-----|-------------| | **Z Image** | `z-image` | Schnelle Text-to-Image-Generierung | ## Kurzvergleich | Funktion | Z Image | |---------|---------| | Eingabe | Textprompt | | Ausgabe | Einzelnes generiertes Bild | | Seitenverhältnisse | Mehrere unterstützte Verhältnisse | | Auflösung | Aus den width/height-Verhältniswerten abgeleitet | | `seed` | Optional | ### Unterstützte Seitenverhältnisse Das Paar `width:height` muss eines der folgenden sein: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### Endpunkt ``` POST /api/v1/image/task ``` ### Anfrageparameter #### Erforderlich | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `model_name` | string | Muss `"z-image"` sein | | `prompt` | string | Prompt für die Bildgenerierung | | `width` | number | Breitenverhältniswert (z. B. `16` für `16:9`) | | `height` | number | Höhenverhältniswert (z. B. `9` für `16:9`) | #### Optionale Parameter | Parameter | Typ | Beschreibung | |-----------|------|-------------| | `seed` | number | Zufalls-Seed im Bereich `[0, 2147483647]`. Verwende `null` oder `0` für zufällige Generierung. | ### Beispielanfrage ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Antwortformat Übermittlungsantwort: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Abfrage mit `GET /api/v1/image/{task_id}`. Aufgabenstatus: `submitted`, `processing`, `succeed`, `failed`. Erfolgreiche Polling-Antworten stellen generierte Bild-URLs unter `data.task_result.images[].url` bereit. ## Bewährte Praktiken - Verwende Verhältniswerte, keine Pixelabmessungen, für `width` und `height`. - Halte Prompts beschreibend, aber auf Motiv, Beleuchtung und Komposition fokussiert. - Verwende einen festen `seed`, wenn du bei Tests reproduzierbare Generierungen möchtest.