# ChatGPT Images 2.6 API Référence complète de l’API pour les modèles ChatGPT Images 2.6 Flare et Sunburst. ## Variantes des modèles Cette API prend en charge quatre variantes de modèles : | Modèle | ID | Description | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Génération d’images à partir de texte avec réglages de résolution et de qualité | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Retouche d’images et composition à partir de plusieurs images | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Génération d’images à partir de texte avec réglages de résolution et de qualité | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Retouche d’images et composition à partir de plusieurs images | ## Comparaison rapide Flare et Sunburst partagent les options de requête suivantes. | Fonctionnalité | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Entrée | Prompt textuel | Image(s) + prompt textuel | | Options de résolution | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Options de qualité | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Qualité par défaut | `medium` | `medium` | | Rapports largeur/hauteur | 10 options | 10 options | | Images en entrée | Non | Obligatoires (1 à 16 images) | | Formats de sortie | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Format de sortie par défaut | `png` | `png` | ### Rapports largeur/hauteur pris en charge `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (Texte vers image) ### Point de terminaison ``` POST /api/v1/image/task ``` ### Authentification ``` Authorization: Bearer YOUR_API_KEY ``` ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"gpt-image-2.6-flare"` | | `prompt` | string | Prompt de génération d’image | | `width` | integer | Valeur de largeur du rapport, par exemple `16` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `height` | integer | Valeur de hauteur du rapport, par exemple `9` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | Le rapport width:height doit correspondre à l’un des rapports largeur/hauteur pris en charge ci-dessus. #### Facultatifs | Paramètre | Type | Valeur par défaut | Description | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Format de sortie : `"png"`, `"jpeg"`, `"webp"`, `"gif"` ou `"svg"`. Utilisez `"gif"` pour une animation GIF ou `"svg"` pour une sortie vectorielle SVG | | `frame_count` | integer | `9` | Nombre d’images de l’animation GIF, de `2` à `16`. S’applique uniquement lorsque `output_format` est `"gif"` | | `frame_duration_ms` | integer | `200` | Durée de chaque image de l’animation GIF en millisecondes, de `20` à `2000`. S’applique uniquement lorsque `output_format` est `"gif"` | ### 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: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (Retouche d’images) ### Point de terminaison ``` POST /api/v1/image/task ``` ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Description des modifications souhaitées | | `image_url_list` | string[] | URL des images d’entrée ; au moins 1 et au plus 16 images, chacune de moins de 50 Mo | | `width` | integer | Valeur de largeur du rapport, par exemple `16` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `height` | integer | Valeur de hauteur du rapport, par exemple `9` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | Le rapport width:height doit correspondre à l’un des rapports largeur/hauteur pris en charge ci-dessus. #### Facultatifs | Paramètre | Type | Valeur par défaut | Description | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Format de sortie : `"png"`, `"jpeg"` ou `"webp"` | ### 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: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (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 `"gpt-image-2.6-sunburst"` | | `prompt` | string | Prompt de génération d’image | | `width` | integer | Valeur de largeur du rapport, par exemple `16` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `height` | integer | Valeur de hauteur du rapport, par exemple `9` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | Le rapport width:height doit correspondre à l’un des rapports largeur/hauteur pris en charge ci-dessus. #### Facultatifs | Paramètre | Type | Valeur par défaut | Description | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Format de sortie : `"png"`, `"jpeg"`, `"webp"`, `"gif"` ou `"svg"`. Utilisez `"gif"` pour une animation GIF ou `"svg"` pour une sortie vectorielle SVG | | `frame_count` | integer | `9` | Nombre d’images de l’animation GIF, de `2` à `16`. S’applique uniquement lorsque `output_format` est `"gif"` | | `frame_duration_ms` | integer | `200` | Durée de chaque image de l’animation GIF en millisecondes, de `20` à `2000`. S’applique uniquement lorsque `output_format` est `"gif"` | ### 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: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (Retouche d’images) ### Point de terminaison ``` POST /api/v1/image/task ``` ### Paramètres de requête #### Obligatoires | Paramètre | Type | Description | |-----------|------|-------------| | `model_name` | string | Doit être `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Description des modifications souhaitées | | `image_url_list` | string[] | URL des images d’entrée ; au moins 1 et au plus 16 images, chacune de moins de 50 Mo | | `width` | integer | Valeur de largeur du rapport, par exemple `16` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `height` | integer | Valeur de hauteur du rapport, par exemple `9` pour `16:9` ; il ne s’agit pas d’une dimension en pixels | | `resolution` | string | `"1k"`, `"2k"` ou `"4k"` | Le rapport width:height doit correspondre à l’un des rapports largeur/hauteur pris en charge ci-dessus. #### Facultatifs | Paramètre | Type | Valeur par défaut | Description | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` ou `"max"` | | `output_format` | string | `"png"` | Format de sortie : `"png"`, `"jpeg"` ou `"webp"` | ### 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: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Format de réponse ### Réponse initiale Les quatre variantes de ChatGPT Images 2.6 renvoient un `task_id` pour les interrogations périodiques : ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Réponse aux interrogations périodiques Interrogez périodiquement `GET /api/v1/image/{task_id}` pour vérifier l’état : ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### Valeurs d’état - `submitted`: Tâche acceptée - `processing`: Génération ou retouche d’image en cours - `succeed`: Tâche terminée avec succès - `failed`: Échec de la tâche ## Temps de traitement Le temps de traitement varie selon le modèle, les paramètres de sortie, la complexité du prompt et le nombre d’images de référence. Interrogez périodiquement l’API jusqu’à ce que l’état de la tâche soit `succeed` ou `failed` ; une tâche soumise ou en cours de traitement peut ne pas encore contenir d’images résultantes. ## Bonnes pratiques 1. **Décrivez précisément la composition** : ChatGPT Images 2.6 donne les meilleurs résultats lorsque les prompts décrivent clairement le sujet, le cadrage, l’éclairage et le style souhaité. 2. **Adaptez le rapport largeur/hauteur au support de diffusion** : Définissez le rapport à l’avance pour les publications sur les réseaux sociaux, les bannières, les pages produit ou les mises en page éditoriales. 3. **Utilisez des images sources nettes pour les retouches** : Des images nettes et bien éclairées améliorent la préservation de l’identité et la qualité des retouches locales. 4. **Limitez les requêtes multi-images aux références pertinentes** : Pour les requêtes de retouche, fournissez uniquement les images utiles afin d’éviter des indications visuelles contradictoires.