Créer des variations d’image

Selon les capacités du modèle, vous pouvez définir le nombre de variations, leurs dimensions et le format de retour.

POST/v1/images/variations

Générez une ou plusieurs variations visuelles à partir d’une image d’entrée. Celle-ci doit respecter les formats, tailles et dimensions pris en charge par le modèle choisi.

La prise en charge des variations d’image dépend des capacités réelles des modèles visibles pour votre clé API.

Authentification

bearerAuth

AuthentificationBearer <token>

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

Emplacement: header

Corps de requête

multipart/form-data

Envoyez l’image source des variations 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*file

Image servant de base aux variations. Utilisez un PNG carré de moins de 4 MB ; les limites réelles des fichiers dépendent du modèle choisi.

Formatbinary

model?string

Identifiant du modèle de variations d’image à utiliser. Choisissez un modèle visible pour votre clé API et prenant en charge les variations d’image.

Longueur1 <= length

n?integer|null

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

Plage1 <= value <= 10

Valeur par défaut1

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 ; les valeurs prises en charge sont 256x256, 512x512 et 1024x1024.

Valeur par défaut"1024x1024"

Valeurs autorisées

"256x256"
"512x512"
"1024x1024"
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/variations" \  -F image="otter.png" \  -F model="MODEL_ID" \  -F n="2" \  -F size="1024x1024"

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

Créer des variations d’image

Authentification

Corps de requête

Corps de réponse

200application/json

401application/json

`application/json`

`application/json`