Aller au contenu
Site principal Actualités Console

API d’édition d’images

L’interface d’édition d’images modifie l’image originale selon l’invite (changer l’arrière-plan, modifier des éléments, styliser, etc.), GPT-Image et la série d’images Gemini sont tous deux utilisables.

Interface

POST https://api.4allapi.com/v1/images/edits

Format multipart/form-data, principaux champs :

ChampDescription
modelNom du modèle d’image, par exemple gpt-image-2, gemini-3.1-flash-image
imageFichier de l’image originale (plusieurs possibles, image[])
promptInstruction d’édition

Exemple

Fenêtre de terminal
curl https://api.4allapi.com/v1/images/edits \
-H "Authorization: Bearer $AIPROXY_KEY" \
-F model="gpt-image-2" \
-F image="@product.png" \
-F prompt="Remplacez l’arrière-plan par une scène chaleureuse de salon de Noël tout en conservant le sujet principal inchangé"
resp = client.images.edit(
model="gpt-image-2",
image=open("product.png", "rb"),
prompt="Remplacez l’arrière-plan par une scène de coucher de soleil sur la plage",
)
print(resp.data[0].url or resp.data[0].b64_json[:50])

Points clés d’utilisation

  • Pour une entrée multi-images (par exemple image de produit + image de style de référence), transmettez plusieurs champs image dans l’ordre, en précisant le rôle de chaque image dans l’invite ;
  • L’édition est également facturée à l’usage ; le format d’image/la résolution restent contrôlés par le suffixe du nom du modèle ;
  • Pour conserver la cohérence d’une personne/d’un produit, indiquez clairement dans l’invite « conserver le sujet inchangé », et privilégiez un format de sortie dont la résolution est proche de celle de l’image originale ;
  • La stratégie de timeout et de nouvelle tentative est la même que celle décrite dans Remarques sur l’utilisation des images