ChatGPT Images 2.5 API

Référence complète de l’API pour les modèles ChatGPT Images 2.5 Client, Flare et Sunburst.

Variantes du modèle

Cette API prend en charge six variantes de modèle disponibles :

Comparaison rapide

Flare et Sunburst partagent les options de requête suivantes. Les variantes Client conservent leurs options existantes, présentées dans le second tableau.

Rapports d’aspect 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.5 Client (génération d’images à partir de texte)

Point de terminaison

POST /api/v1/image/task

Authentification

Authorization: Bearer YOUR_API_KEY

Paramètres de la requête

Obligatoires

Remarque : Le rapport largeur:hauteur doit être l’un des suivants : 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Exemple de requête

javascriptCopier
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: 'chatgpt-images-2.5-client',
    prompt: 'A minimalist product shot of a ceramic mug on marble, soft studio light',
    width: 1,
    height: 1,
    resolution: '1k'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { Authorization: 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

ChatGPT Images 2.5 Edit Client (retouche d’images)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Remarque : Le rapport largeur:hauteur doit être l’un des suivants : 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

Exemple de retouche d’une seule image

javascriptCopier
{
  model_name: 'chatgpt-images-2.5-edit-client',
  prompt: 'Replace the background with a clean studio scene and brighten the product lighting',
  image_url_list: ['https://example.com/product-photo.jpg'],
  width: 16,
  height: 9,
  resolution: '1k'
}

Exemple de composition à partir de plusieurs images

javascriptCopier
{
  model_name: 'chatgpt-images-2.5-edit-client',
  prompt: 'Blend these reference images into a polished campaign composition while keeping the main subject identity consistent',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ],
  width: 16,
  height: 9,
  resolution: '1k'
}

ChatGPT Images 2.5 Flare (génération d’images à partir de texte)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Le rapport largeur:hauteur doit correspondre à l’un des rapports d’aspect pris en charge indiqués ci-dessus.

Facultatifs

Exemple de requête

javascriptCopier
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.5-flare',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Flare Edit (retouche d’images)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Le rapport largeur:hauteur doit correspondre à l’un des rapports d’aspect pris en charge indiqués ci-dessus.

Facultatifs

Exemple de requête

javascriptCopier
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.5-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'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Sunburst (génération d’images à partir de texte)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Le rapport largeur:hauteur doit correspondre à l’un des rapports d’aspect pris en charge indiqués ci-dessus.

Facultatifs

Exemple de requête

javascriptCopier
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.5-sunburst',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Sunburst Edit (retouche d’images)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Le rapport largeur:hauteur doit correspondre à l’un des rapports d’aspect pris en charge indiqués ci-dessus.

Facultatifs

Exemple de requête

javascriptCopier
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.5-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'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Format de réponse

Réponse initiale

Les six variantes de ChatGPT Images 2.5 renvoient un task_id pour l’interrogation périodique :

jsonCopier
{
  "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 à l’interrogation périodique

Interrogez régulièrement GET /api/v1/image/{task_id} pour vérifier l’état :

jsonCopier
{
  "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é de l’instruction et le nombre d’images de référence. Interrogez régulièrement le service 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.5 donne les meilleurs résultats lorsque les instructions décrivent clairement le sujet, le cadrage, l’éclairage et le style souhaité.
2. Adaptez le rapport d’aspect au support de diffusion : définissez le rapport dès le départ 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 de bonne qualité pour les retouches : des images nettes et bien éclairées améliorent la préservation de l’identité du sujet 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.