Skip to main content

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 moins 120s. 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 est url)
  • b64_json (string) : Image encodée en Base64 (si response_format est b64_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.