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é.
file
requis
L’image à utiliser comme base pour la variation. Doit être un fichier PNG valide, inférieur à 50 Mo et carré.
string
requis
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.integer
défaut:"1"
Le nombre d’images à générer. Doit être compris entre 1 et 10.
string
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é.
string
défaut:"url"
Le format de retour des images générées. Doit être
url ou b64_json.string
Identifiant unique représentant votre utilisateur final pour la surveillance des abus.
Réponse
integer
Horodatage Unix de la création des images.
array
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.