/v1/images/generations pour la génération d’images en production.
Variante synchrone
/v1/images/generations/sync crée une tâche et attend jusqu’au temps d’attente maximum configuré.
Utilisez-la pour la compatibilité et les démos. Utilisez l’endpoint asynchrone pour les charges de travail en production.
Édition d’images
/v1/images/edits prend en charge les workflows d’édition d’images de style OpenAI lorsque le modèle sélectionné prend en charge les images de référence.
Qualité et routage de GPT Image 2.5
gpt-image-2.5 est un alias fixe de Flare ; utilisez gpt-image-2.5-sunburst pour l’édition précise. quality (auto/low/medium/high/xhigh/max) et resolution (1K/2K/4K) sont indépendants. Les pixels explicites doivent correspondre à la résolution, et APIAny choisit uniquement les routes compatibles par coût sans supprimer de champs.
GPT Image 2.6
gpt-image-2.6 utilise les endpoints d’image existants pour PNG et GIF animé ; aucune API GIF distincte n’est nécessaire. Chaque requête réussie coûte 30 crédits et renvoie un résultat. Vérifiez la disponibilité dans GET /v1/models avant l’appel.
Utilisez output_format: "png" (par défaut) ou "gif", quality: "auto", resolution: "1K" et n: 1. size accepte auto, 1:1, 3:2, 2:3, 1024x1024, 1536x1024 ou 1024x1536. Une seule référence est acceptée. Les alias et model_params ont les mêmes limites ; les valeurs contradictoires renvoient HTTP 400.
SVG, JPEG, WebP, 2K/4K, les masques, la compression, frame_count et frame_duration_ms ne sont pas pris en charge. Les dimensions, le nombre d’images et les intervalles du GIF ne sont pas configurables. background peut être omis et accepte seulement auto. Une requête SVG renvoie HTTP 400, pas un PNG.
PNG avec attente synchrone
GIF avec une image de référence
L’endpoint d’édition accepte un JSON contenant une entréeimage_urls ou un fichier multipart image. N’ajoutez pas de masque. output_format choisit le format de sortie ; l’édition GIF renvoie également un seul fichier animé.
200 avec data[0].url une fois terminés, ou HTTP 202 avec task_id et poll_url en attente. Interrogez /v1/tasks/{task_id} jusqu’à completed ou failed et gardez le même ID pour pending ou processing. La génération asynchrone utilise /v1/images/generations et le fichier terminé se trouve dans result.data[0].url. Les résultats GIF invalides ou statiques échouent et suivent la politique normale de remboursement des crédits pour les tâches échouées.
Paramètres complets, exemples PNG/GIF asynchrones et réponses de suivi