Créer une image

Générez des images à partir d’un prompt textuel via l’API compatible OpenAI.

Selon les capacités du modèle, vous pouvez définir le nombre d’images, leurs dimensions, leur qualité, leur style et le format de retour.

POST/v1/images/generations

Créez une ou plusieurs images à partir d’un prompt textuel. Décrivez le sujet, la scène, la composition, le point de vue, le style artistique et l’ambiance générale, puis ajustez le résultat avec les dimensions, la qualité et le format de réponse pris en charge par le modèle.

Les modèles disponibles et les contraintes des paramètres n, quality, size, style, entre autres, dépendent du modèle choisi. Utilisez l’identifiant d’un modèle visible pour votre clé API et prenant en charge la génération d’images.

Authentification

bearerAuth

AuthentificationBearer <token>

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

Emplacement: header

Corps de requête

application/json

Paramètres de requête de génération d’images.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model?string

Identifiant du modèle de génération d’images à utiliser. Choisissez un modèle visible pour votre clé API et prenant en charge la génération d’images ; les paramètres et limites peuvent varier selon le modèle.

Longueur1 <= length

prompt*string

Description textuelle de l’image souhaitée. Précisez le sujet, les principaux éléments visuels, la composition, le point de vue, le style artistique et l’ambiance.

DALL·E 2 accepte jusqu’à 1 000 caractères et DALL·E 3 jusqu’à 4 000 caractères ; les limites des autres modèles dépendent de leurs capacités réelles. Si la génération échoue, vérifiez également que le prompt respecte la politique de contenu.

Longueur1 <= length

n?integer|null

Nombre d’images à générer, de 1 à 10. DALL·E 3 prend uniquement en charge n=1 ; pour les autres modèles, le retour de plusieurs images dépend de leurs capacités réelles.

Plage1 <= value <= 10

Valeur par défaut1

quality?string

Qualité de l’image. hd peut produire des images plus détaillées et cohérentes et s’applique uniquement à DALL·E 3 ; les autres modèles peuvent utiliser d’autres valeurs.

Valeur par défaut"standard"

Valeurs autorisées

"standard"
"hd"

response_format?string|null

Format de réponse des images. url renvoie une URL temporaire 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. DALL·E 2 prend en charge 256x256, 512x512 et 1024x1024 ; DALL·E 3 prend en charge 1024x1024, 1792x1024 et 1024x1792.

Valeur par défaut"1024x1024"

Valeurs autorisées

"256x256"
"512x512"
"1024x1024"
"1792x1024"
"1024x1792"
null

style?string|null

Style de l’image. vivid privilégie un rendu surréaliste et dramatique, tandis que natural privilégie un rendu naturel et réaliste. Ce paramètre s’applique uniquement à DALL·E 3.

Valeur par défaut"vivid"

Valeurs autorisées

"vivid"
"natural"
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/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Une adorable petite loutre de mer joue dans une eau limpide, sous une lumière naturelle douce, avec des détails nets",    "n": 1,    "size": "1024x1024"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "Une adorable petite loutre de mer joue dans une eau limpide ; elle a des yeux ronds et une fourrure duveteuse."
    }
  ]
}

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`