Modifier une image
Crée des images à partir d’un prompt et d’une ou plusieurs images de référence, envoyées en fichiers dans un formulaire multipart ou en liens.
Crée des images à partir d’un prompt et d’une ou plusieurs images de référence, envoyées en fichiers dans un formulaire multipart ou en liens.
apiKeyAuthorizationBearer <token>Votre clé API, envoyée sous la forme Authorization: Bearer <key>.
Idempotency-Key?stringUne valeur de votre choix, jusqu’à 255 caractères. Renvoyer la même valeur ne crée ni ne facture une seconde requête ; la réponse est 409.
length <= 255multipart/form-data- body
model*stringLe modèle à utiliser.
"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"prompt*stringCe que l’image doit montrer. Jusqu’à 32 000 caractères.
length <= 32000n?integerNombre d’images à créer. Une requête utilise n fois les crédits du modèle. Au plus 10 en 1K, 4 en 2K et 2 en 4K.
1 <= value <= 101size?stringauto laisse le modèle choisir (sur un modèle à résolution unique, cette résolution). Les autres valeurs sont des tailles 1K, 2K et 4K ; chaque modèle accepte les résolutions indiquées sur sa fiche à /fr/models, au même prix. Voir le guide des tailles pour le format de chacune. gpt-image-2-adobe et gpt-image-2.5-flare acceptent aussi une largeur et une hauteur de votre choix : multiples de 16, jusqu’à 3840 px par côté, pas plus long que 3:1, de 655 360 à 8 294 400 pixels.
"auto""auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"quality?stringQualité de rendu, prise en compte par gpt-image-2-adobe et les variantes flare et sunburst ; les autres modèles GPT la choisissent eux-mêmes et Nano Banana l’ignore. xhigh et max fonctionnent uniquement sur gpt-image-2.5-sunburst. Toutes les qualités coûtent le même prix.
"auto""auto""low""medium""high""xhigh""max"background?stringAucun modèle ne produit de fond transparent pour le moment, donc transparent renvoie une erreur 400. auto et opaque fonctionnent sur tous les modèles.
"auto""auto""opaque"output_format?stringFormat de fichier des images renvoyées. gif fonctionne sur gpt-image-2.6 et ses variantes flare et sunburst, svg sur gpt-image-2.6 uniquement. png, jpeg et webp fonctionnent sur tous les modèles.
"png""png""jpeg""webp""gif""svg"output_compression?integerQualité pour jpeg et webp, de 0 à 100. 100 par défaut.
0 <= value <= 100moderation?stringRigueur du contrôle du prompt et du résultat. low est moins restrictif.
"auto""auto""low"response_format?stringb64_json renvoie les données de l’image dans la réponse. url renvoie un lien vers l’image, conservé 72 heures.
"b64_json""b64_json""url"async?booleanMettez true pour exécuter la requête en arrière-plan. La réponse est 202 avec une tâche tout de suite ; lisez le résultat plus tard avec GET /images/tasks/{id}. Les images sont renvoyées sous forme de liens, donc response_format doit valoir url ou être omis. L’en-tête Prefer: respond-async fait la même chose.
falsewebhook_url?stringAvec async : une adresse https:// qui reçoit un POST de la tâche terminée (le même JSON que GET /images/tasks/{id}). Jusqu’à 3 tentatives. Envoyez webhook_secret pour faire signer l’appel ; sans lui, vérifiez ce que vous recevez en lisant la tâche avec votre clé.
uriwebhook_secret?stringAvec webhook_url : un secret de votre choix, de 16 à 128 caractères. L’appel vers votre adresse porte alors x-webhook-signature: t=<unix seconds>,v1=<hex>, où le hex est le HMAC-SHA256 de <t>.<body> calculé avec ce secret.
16 <= length <= 128image[]*array<>Images de référence : PNG, JPEG ou WebP, de 1 à 16 fichiers, chacun jusqu’à 20 Mo, 50 Mo au total.
1 <= items <= 16input_fidelity?stringFidélité du résultat aux détails des images de référence. Non accepté par gpt-image-2.
"low""high"Les images.
application/json- response
created*integerMoment de création des images, sous forme d’horodatage Unix en secondes.
data*array<>curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \ -F 'model=gpt-image-2' \ -F 'prompt=string' \ -F 'image[]=[ "string"]'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}Créer une image POST
Crée une ou plusieurs images à partir d’un prompt. Les crédits sont réservés au début de la requête et rendus pour chaque image non livrée.
Lire une tâche GET
Lit l’état d’une requête asynchrone à partir de son identifiant de tâche : `in_progress`, puis `succeeded` avec les images ou `failed` avec l’erreur. Une tâche peut être lue tant que ses images sont conservées, soit 72 heures. Interrogez toutes les quelques secondes ; lire une tâche ne compte pas comme une requête en cours. Pour attendre plusieurs tâches, utilisez `GET /images/tasks?ids=` et lisez-les en un seul appel.