Aller au contenu
Cheapest Imagen
Référence de l’API

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.

POST
/images/edits

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.

Authorization

apiKey
headerAuthorizationBearer <token>

Votre clé API, envoyée sous la forme Authorization: Bearer <key>.

Header Parameters

Idempotency-Key?string

Une 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.

Lengthlength <= 255

Request Body

multipart/form-data
  1. body
model*string

Le modèle à utiliser.

Value in"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*string

Ce que l’image doit montrer. Jusqu’à 32 000 caractères.

Lengthlength <= 32000
n?integer

Nombre 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.

Range1 <= value <= 10
Default1
size?string

auto 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.

Default"auto"
Value in"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?string

Qualité 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.

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

Aucun 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.

Default"auto"
Value in"auto""opaque"
output_format?string

Format 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.

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

Qualité pour jpeg et webp, de 0 à 100. 100 par défaut.

Range0 <= value <= 100
moderation?string

Rigueur du contrôle du prompt et du résultat. low est moins restrictif.

Default"auto"
Value in"auto""low"
response_format?string

b64_json renvoie les données de l’image dans la réponse. url renvoie un lien vers l’image, conservé 72 heures.

Default"b64_json"
Value in"b64_json""url"
async?boolean

Mettez 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.

Defaultfalse
webhook_url?string

Avec 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é.

Formaturi
webhook_secret?string

Avec 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.

Length16 <= length <= 128
image[]*array<>

Images de référence : PNG, JPEG ou WebP, de 1 à 16 fichiers, chacun jusqu’à 20 Mo, 50 Mo au total.

Items1 <= items <= 16
input_fidelity?string

Fidélité du résultat aux détails des images de référence. Non accepté par gpt-image-2.

Value in"low""high"

Response Body

Les images.

application/json
  1. response
created*integer

Moment de création des images, sous forme d’horodatage Unix en secondes.

data*array<>
Example Request
curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \  -F 'model=gpt-image-2' \  -F 'prompt=string' \  -F 'image[]=[  "string"]'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}