Créer / modifier des images

POST/v1/images/generations

Génère ou modifie les images de manière synchrone. Lorsque image est fourni, les références sont modifiées selon la consigne.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une clé API de la plateforme.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle sur la plateforme.

prompt*string

Décrivez l’image à générer ou les modifications à apporter à la référence.

Longueur1 <= length

image?|array<>

Jusqu’à 3 références. Chaque image doit peser au plus 10 MB, avoir un rapport grand côté/petit côté maximal de 10:1 et des dimensions de 1–8000 pixels. Omettez ce champ pour le texte vers image. null ou un tableau vide provoque une erreur.

n?integer

Nombre d’images de sortie.

Plage1 <= value <= 6

Valeur par défaut1

size?string

Dimensions WIDTHxHEIGHT ou auto. Sans valeur, le modèle choisit. Surface de 512×512 à 2048×2048 pixels et rapport de 1:8 à 8:1.

negative_prompt?string

Décrivez les éléments à exclure.

seed?integer

Graine aléatoire.

Plage0 <= value <= 2147483647

prompt_extend?boolean

Activer ou non l’enrichissement de la consigne.

Valeur par défauttrue

prompt_extend_mode?string

Mode d’enrichissement. agent sert uniquement au texte vers image et renvoie 400 pour la modification.

Valeur par défaut"direct"

Valeurs autorisées

"direct"
"agent"

enable_thinking?boolean

Activer ou non le raisonnement. Applicable uniquement si prompt_extend vaut true.

Valeur par défauttrue

watermark?boolean

Ajouter ou non un filigrane.

Valeur par défautfalse

response_format?string

Renvoie toujours des URL d’images. b64_json est ignoré.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Créez une photo d’une tasse blanche sur un bureau en bois, éclairée doucement par une fenêtre à gauche."
  }'

{
  "created": 1793980667,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

Remplacez l’URL de l’exemple de modification par celle de l’image créée à l’étape précédente. Pour Base64, remplacez BASE64_BYTES par les données réelles et conservez le préfixe Data URL correspondant au format.

API Alibaba Cloud de génération et modification d’images QwenChamps et format de réponse de l’API compatible OpenAI.

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`