Skip to main content
POST

Modèles pris en charge

Préférez -pro pour le texte/mise en page dense. Utilisez qwen-image-3.0 pour les images générales. Prompt max ~4.5k tokens. Les noms de modèles ne sont pas interchangeables avec la série 2.0.

Autorisations

string
requis
Tous les points de terminaison nécessitent une authentification Bearer TokenObtenez votre clé API depuis la page de gestion des clés API :

Body

string
requis
Nom du modèle
  • qwen-image-3.0 - Standard
  • qwen-image-3.0-pro - Pro (texte / mise en page dense)
string
requis
Description textuelle pour la génération d’images, max ~4.5k tokens
string[]
Tableau d’URL d’images de référence (image-vers-image / édition), 1-3 images
  • URL publique http(s):// ou data:image/png;base64,... (le base64 est d’abord re-téléversé)
  • Formats : JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
  • Par fichier ≤ 10MB ; largeur/hauteur recommandées 384-2048 px
string
défaut:"1K"
Niveau de résolution (affecte le palier de facturation)
  • 1K (par défaut ; minuscules acceptées)
  • 2K
Vous pouvez omettre le palier et passer les pixels dans size (ex. 1600x900). Avec des pixels bruts, une surface > 2,25M pixels est facturée en 2K.
string
défaut:"1:1"
Rapport d’aspect, ou taille en pixels expliciteRapports pris en charge :
  • 1:1 (par défaut)
  • 4:3 / 3:4
  • 16:9 / 9:16
  • 3:2 / 2:3
Accepte aussi le style 16x9, ou des pixels comme 1024x1024. Pour des pixels personnalisés, chaque côté (largeur et hauteur) doit être 512–2048, ratio d’aspect 1:8 ~ 8:1.Si ni size ni resolution n’est défini, la sortie est fixée à 1024×1024.
integer
défaut:"1"
Nombre d’images, 1-6. Les valeurs supérieures à 6 sont plafonnées à 6.
string
Prompt négatif : contenu à éviter
boolean
défaut:"false"
Réécriture intelligente du promptDésactivé par défaut pour des résultats prévisibles. Passez à true pour activer la réécriture intelligente.
string
Mode de réécriture (série 3.0 uniquement ; nécessite prompt_extend: true)
  • direct - fonctionne pour texte-vers-image et image-vers-image
  • agent - texte-vers-image uniquement, réécriture plus agressive
Les valeurs invalides sont ignorées.

Tableau de référence des tailles

Combinez resolution (palier) + size (rapport) :

Cas d’usage

Texte-vers-image (multiple)

Mise en page dense avec réécriture

Image-vers-image (édition)

Prompt négatif

Limites

Response

integer
Code de statut ; 200 en cas de succès
array
Tableau de données de la réponse

Différences par rapport à 2.0

Remarques

  1. Asynchrone : la soumission renvoie un task_id. Interrogez Obtenir le statut d’une tâche toutes les 3~5 secondes ; timeout client ~3 minutes (2K + multi-images est plus lent).
  2. Stockage : les images sont mises en miroir sur le CDN de la plateforme pour un accès à long terme.
  3. Facturation : par image livrée × palier de résolution selon la surface en pixels réelle (> 2,25M pixels = 2K). qwen-image-3.0 facture le même prix pour 1K/2K ; -pro 2K est 2× 1K. Les échecs sont entièrement remboursés ; les images de référence sont gratuites.
  4. Erreurs : taille/ratio invalide, agent sur image-vers-image, références inaccessibles/trop volumineuses → 400 ; limite de débit → 429.
Consulter les résultatsUtilisez Obtenir le statut d’une tâche pour la progression et result.images.