Aller au contenu
Cheapest Imagen
Guides

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=url

Avec 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ête1 à 16
Taille d’une imagejusqu’à 20 Mo
Taille de toute la requêtejusqu’à 50 Mo
Types de fichierPNG, 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 :

ChampRôleValeurs
input_fidelityFidélité du résultat aux détails des images de référencelow (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: transparent renvoie 400 sur 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.

Sur cette page