Aperçu
Cet endpoint est conservé pour les clients legacy de variations compatibles OpenAI. Ce n’est pas le chemin recommandé pour les workflows image-to-image actuels ; utilisez/v1/images/edits avec gpt-image-2 ou /v1/images/generations avec un modèle image-to-image comme nano-banana-pro lorsque possible. Requiert multipart/form-data.
Corps de la requête
Timeout des requêtes synchrones : certains fournisseurs d’images routés renvoient l’image finale inline et attendent la fin de la génération. Les requêtes haute résolution ou haute qualité peuvent prendre près d’une minute, voire plus ; configurez donc le timeout de votre client HTTP à au moins120s. Si la réponse de création contient status: "pending", task_id ou poll_url, suivez plutôt le poll_url renvoyé.
L’image à utiliser comme base pour la variation. Doit être un fichier PNG valide, inférieur à 50 Mo et carré.
Identifiant de modèle obligatoire pour les routes legacy compatibles avec les variations. Il n’y a pas de valeur par défaut implicite ; pour les workflows image-to-image actuels, préférez
/v1/images/edits ou /v1/images/generations avec un modèle actuel.Le nombre d’images à générer. Doit être compris entre 1 et 10.
Taille des images générées pour les routes legacy compatibles avec les variations. Les valeurs prises en charge dépendent du modèle sélectionné.
Le format de retour des images générées. Doit être
url ou b64_json.Identifiant unique représentant votre utilisateur final pour la surveillance des abus.
Réponse
Horodatage Unix de la création des images.
Tableau des variations d’images générées.Chaque objet contient :
url(string) : URL de l’image de variation (si response_format esturl)b64_json(string) : Image encodée en Base64 (si response_format estb64_json)
Notes
Il s’agit d’un endpoint de compatibilité legacy. Il n’est pas inclus dans le catalogue actuel des modèles image recommandés. Pour les nouvelles intégrations, utilisez
/v1/images/edits avec gpt-image-2, ou /v1/images/generations avec operation: "image-to-image" et un modèle image-to-image actuel.