# API Z Image Référence API complète pour la génération texte-vers-image Z Image. ## Variantes du modèle Cette API prend en charge une variante du modèle : | Modèle | ID | Description | |-------|-----|-------------| | **Z Image** | `z-image` | Génération texte-vers-image rapide | ## Comparaison rapide | Fonctionnalité | Z Image | |---------|---------| | Entrée | Prompt texte | | Sortie | Une seule image générée | | Ratios d'aspect | Plusieurs ratios pris en charge | | Résolution | Déduite des valeurs de ratio width/height | | `seed` | Facultatif | ### Ratios d'aspect pris en charge La paire `width:height` doit être l'une des suivantes : `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (texte-vers-image) ### Point de terminaison ``` POST /api/v1/image/task ``` ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"z-image"` | | `prompt` | string | Prompt de génération d'image | | `width` | number | Valeur de ratio de largeur (par exemple, `16` pour `16:9`) | | `height` | number | Valeur de ratio de hauteur (par exemple, `9` pour `16:9`) | #### Facultatifs | Paramètre | Type | Description | |-----------|------|-------------| | `seed` | number | Graine aléatoire dans la plage `[0, 2147483647]`. Utilisez `null` ou `0` pour une génération aléatoire. | ### Exemple de requête ```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; ``` ## Format de réponse Réponse de soumission : ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Interrogez avec `GET /api/v1/image/{task_id}`. Statuts de tâche : `submitted`, `processing`, `succeed`, `failed`. Les réponses de polling réussies exposent les URL des images générées sous `data.task_result.images[].url`. ## Bonnes pratiques - Utilisez des valeurs de ratio, et non des dimensions en pixels, pour `width` et `height`. - Gardez les prompts descriptifs mais centrés sur le sujet, l'éclairage et la composition. - Utilisez un `seed` fixe lorsque vous voulez des générations reproductibles pendant les tests.