Modifier une image

Générez une image modifiée à partir d’une ou plusieurs images d’entrée et d’un prompt textuel. Vous pouvez également utiliser un masque pour indiquer les zones à modifier.

POST/v1/images/edits

Créez des images modifiées à partir d’une ou plusieurs images d’entrée et d’un prompt textuel. Si un masque est fourni, ses zones transparentes indiquent les régions à modifier ; pour une modification de plusieurs images, le masque s’applique à la première image d’entrée.

Les types, tailles et nombres de fichiers d’entrée, les règles relatives au masque, ainsi que les options de qualité et de dimensions dépendent du modèle choisi. Utilisez l’identifiant d’un modèle visible pour votre clé API et prenant en charge la modification d’images.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

multipart/form-data

Envoyez les images, le prompt et le masque facultatif en Multipart. Le client doit laisser la bibliothèque de requêtes générer automatiquement la boundary du Content-Type.

Définitions TypeScript

Utilisez le type request body en TypeScript.

image*|array<>

Une ou plusieurs images à modifier. DALL·E 2 accepte un PNG carré de moins de 4 MB ; si mask est absent, l’image doit comporter des zones transparentes. GPT-Image-1 accepte plusieurs images PNG, WEBP ou JPG, chacune de moins de 25 MB.

Les formats, tailles et nombres de fichiers réellement pris en charge dépendent du modèle choisi.

prompt*string

Résultat de modification souhaité. DALL·E 2 accepte jusqu’à 1 000 caractères et GPT-Image-1 jusqu’à 32 000 caractères ; les limites des autres modèles dépendent de leurs capacités réelles.

Longueur1 <= length

mask?file

Image de masque facultative. Les zones entièrement transparentes indiquent les régions à modifier. Le masque doit être un PNG de moins de 4 MB, de mêmes dimensions que l’image d’entrée ; pour plusieurs images, il s’applique à la première.

Formatbinary

model*string

Identifiant du modèle de modification d’images à utiliser. Choisissez un modèle visible pour votre clé API et prenant en charge la modification d’images.

Longueur1 <= length

n?integer|null

Nombre d’images à renvoyer, de 1 à 10 ; le nombre réellement pris en charge dépend du modèle choisi.

Plage1 <= value <= 10

Valeur par défaut1

quality?string|null

Qualité de l’image. GPT-Image-1 prend en charge high, medium et low ; DALL·E 2 utilise standard. La valeur par défaut est auto.

Valeur par défaut"auto"

Valeurs autorisées

"auto"
"high"
"medium"
"low"
"standard"
null

response_format?string|null

Format de réponse des images. url renvoie une URL d’image valide pendant 60 minutes après la génération ; b64_json renvoie les données d’image encodées en Base64.

Valeur par défaut"url"

Valeurs autorisées

"url"
"b64_json"
null

size?string|null

Dimensions de l’image. GPT-Image-1 prend en charge 1024x1024, 1536x1024, 1024x1536 et auto ; DALL·E 2 prend en charge 256x256, 512x512 et 1024x1024.

Valeur par défaut"1024x1024"

Valeurs autorisées

"256x256"
"512x512"
"1024x1024"
"1536x1024"
"1024x1536"
"auto"
null

user?string

Identifiant unique de l’utilisateur final, utilisable pour surveiller et détecter les abus.

Longueur1 <= length

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -F model="MODEL_ID" \  -F image="otter.png" \  -F mask="mask.png" \  -F prompt="Une adorable petite loutre de mer coiffée d’un béret" \  -F n="1" \  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/edited-image-1.png"
    },
    {
      "url": "https://example.com/edited-image-2.png"
    }
  ]
}

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`