Créer une image
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.
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.
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 <= 255application/json- 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 <= 128Les 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/generations' \ -H 'Content-Type: application/json' \ -d '{ "model": "gpt-image-2", "prompt": "a red fox in the snow", "size": "1536x1024"}'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}Utiliser avec n8n
Générez des images dans un workflow n8n avec GPT Image ou Nano Banana via l’API Cheapest Imagen et le nœud HTTP Request. Réglages, corps de la requête et enregistrement.
Modifier une image POST
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.