Modifier des images
Image vers image avec l’API Cheapest Imagen. Envoyez des images de référence à /v1/images/edits avec GPT Image ou Nano Banana, en fichiers ou en liens.
Envoyez un prompt et une ou plusieurs images de référence à POST /v1/images/edits. Tous les modèles acceptent des images de référence, et une modification coûte les mêmes crédits qu’une nouvelle image.
Envoyer des fichiers
Envoyez la requête sous forme de formulaire. Répétez image[] pour chaque image de référence.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlAvec le SDK OpenAI :
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)Envoyer des liens plutôt que des fichiers
Envoyez du JSON avec un tableau images. Chaque élément a un image_url, qui est un lien https: ou une URL data: en base64.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id n’est pas pris en charge ; passez image_url.
Limites
| Images de référence par requête | 1 à 16 |
| Taille d’une image | jusqu’à 20 Mo |
| Taille de toute la requête | jusqu’à 50 Mo |
| Types de fichier | PNG, JPEG, WebP |
Une requête qui dépasse ces limites renvoie 413.
Options
Toutes les options de texte vers image fonctionnent pour les modifications : n, size, quality, output_format, response_format. Une option de plus est réservée aux modifications :
| Champ | Rôle | Valeurs |
|---|---|---|
input_fidelity | Fidélité du résultat aux détails des images de référence | low (par défaut), high. Fonctionne sur GPT Image 2.5 et 2.6 et leurs versions flare et sunburst ; les autres modèles renvoient 400 |
Ce qui n’est pas pris en charge
- Masques. Vous ne pouvez pas repeindre une seule zone. Décrivez dans le prompt ce qui doit rester identique.
- Fonds transparents.
background: transparentrenvoie400sur tous les modèles.
Conseils
- Envoyez plusieurs angles du sujet lorsqu’il doit rester identique.
- Dites ce qui ne doit pas changer : « garder l’étiquette inchangée », « même visage et même coiffure ».
- Pour une sortie en 2K et 4K, utilisez Nano Banana,
gpt-image-2-adobe, ou une version flare ou sunburst. Voir Formats et tailles.
Modèles
Tous les identifiants de modèle de l’API Cheapest Imagen, avec le modèle officiel OpenAI ou Google qu’ils exécutent, les résolutions et leur prix en crédits par image.
Formats et tailles
Les tailles d’image que vous pouvez passer dans le champ size de l’API Cheapest Imagen : jusqu’à 19 formats en 1K, 2K et 4K, et des tailles personnalisées.