- Texte vers image.
- Image vers image avec des éléments de référence.
- Génération d’images compatible OpenAI.
- Édition d’images compatible OpenAI.
- Workflows d’images compatibles Gemini.
/v1/images/generations et interrogez /v1/tasks/{task_id}.
Modèles disponibles
GPT Image 2.6 — PNG et GIF animés
Utilisez l’identifiant publicgpt-image-2.6 pour demander une image PNG fixe ou un GIF animé téléchargeable. Chaque requête réussie renvoie un résultat et coûte 30 crédits, quel que soit le format. Vérifiez sa disponibilité dans GET /v1/models avant utilisation ; les exemples ne garantissent pas son activation actuelle.
Paramètres acceptés
output_format:png(par défaut) ougif.quality:autouniquement.resolution:1Kuniquement.n:1uniquement.size:auto,1:1,3:2,2:3,1024x1024,1536x1024ou1024x1536.image_urls: une seule image de référence. Il s’agit de la limite actuelle d’APIAny.AI pour ce modèle. Omettez ce champ pour une génération à partir de texte seul.
frame_count ou frame_duration_ms. SVG, JPEG, WebP, 2K/4K, les masques et la compression ne sont pas pris en charge. background accepte uniquement auto par compatibilité et peut être omis. Les valeurs non prises en charge, dont SVG, renvoient HTTP 400 ; SVG n’est pas remplacé silencieusement par PNG.
Ces limites s’appliquent aussi aux alias de compatibilité au premier niveau et dans model_params. Les valeurs contradictoires renvoient HTTP 400. Préférez les champs canoniques ci-dessous ; la prise en charge de paramètres arbitraires n’est pas garantie.
Créer une tâche PNG
Créer une tâche GIF
Interroger et télécharger
L’endpoint de génération renvoie HTTP202 avec task_id et poll_url. Continuez les requêtes de suivi tant que le statut est pending ou processing, puis arrêtez sur completed ou failed. Ne soumettez pas de nouveau une tâche en cours.
completed, téléchargez le fichier depuis result.data[0].url. Un GIF réussi est un véritable fichier animé, pas une URL vidéo ni un ensemble d’images séparées. Un résultat statique ou au mauvais format pour une requête GIF fait échouer la tâche et suit la politique normale de remboursement des crédits pour les tâches échouées.
/v1/images/generations/sync accepte les mêmes paramètres. HTTP 200 fournit l’URL du fichier dans data[0].url ; HTTP 202 indique qu’il faut continuer à interroger la tâche. /v1/images/edits accepte une référence en JSON ou en multipart, avec les mêmes choix PNG/GIF et 30 crédits par requête réussie. Voir les exemples du guide de génération d’images.
Exemples d’attente synchrone et d’édition d’images
Nano Banana 2.1
Définissezquality sur 1K, 2K ou 4K (par défaut : 1K). Les alias img_size, imageSize et resolution sont acceptés, sans valeurs contradictoires. size définit le format ; utilisez image_urls pour l’édition avec références. Les paramètres 0.5K, de recherche et de réflexion ne sont pas disponibles.
/v1/tasks/{task_id}. Prix par image : 25 crédits en 1K, 50 en 2K et 75 en 4K.