Passer au contenu principal
POST

Autorisations

string
requis
Tous les points de terminaison nécessitent une authentification Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIIncluez-la dans l’en-tête de la requête :

Body

string
défaut:"mai-image-2.7"
requis
Nom du modèle de génération d’imagesLes deux modèles ont exactement les mêmes capacités et paramètres.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description textuelle de l’image à générer ou instructions de retouche
  • Prend en charge le chinois et l’anglais, des descriptions détaillées sont recommandées
  • 20 000 caractères maximum ; au-delà, une erreur 400 est renvoyée
  • Ne peut pas être vide ni composé uniquement d’espaces
integer
défaut:"1"
Nombre d’images à générerValeur : 1
Une seule image par requête : soumettez des tâches séparées pour plusieurs images. Une valeur 0, négative ou supérieure à 1 renvoie 400
string
défaut:"1:1"
Ratio d’aspect ou dimensions en pixels de l’image, uniquement pour le texte en imageDeux formats sont acceptés :
  • Ratio d’aspect : tout rapport d’entiers entre 1:4 et 4:1, par exemple 1:1, 16:9, 9:16, 21:9 ; combiné à resolution, il détermine les pixels réels
  • Dimensions en pixels : largeurxhauteur (ou largeur*hauteur, largeur×hauteur), par exemple 2048x1152 ; resolution est alors ignoré
Contraintes des dimensions en pixels :
  • Largeur et hauteur ≥ 768 chacune
  • Largeur × hauteur ≤ 4 194 304 (2048×2048)
  • Largeur et hauteur sont chacune arrondies au multiple de 32 inférieur, par exemple 1000x1000 produit en réalité 992x992
Exemples : ✅ 2048x2048, 2048x1152, 2560x1536 ; ❌ 512x512 (côté inférieur à 768), 2080x2048 (nombre total de pixels dépassé)
auto n’est pas pris en charge et renvoie 400
string
défaut:"1K"
Niveau de résolution de sortie, uniquement lorsque size est un ratio d’aspectOptions : 1K / 2K (minuscules acceptées)Correspondance size × resolution → pixels réels :
La 4K n’est pas prise en charge ; tout autre niveau renvoie 400. Le petit côté devant atteindre au moins 768, les ratios plus allongés que 2:1 dépassent en réalité environ 1 million de pixels au niveau 1K.
integer
Largeur exacte en pixels, à fournir obligatoirement avec height
  • Priorité la plus élevée : lorsqu’elle est fournie, elle remplace size et resolution
  • Mêmes contraintes que les dimensions en pixels de size : largeur et hauteur ≥ 768, total ≤ 4 194 304 pixels
  • Uniquement pour le texte en image
integer
Hauteur exacte en pixels, à fournir obligatoirement avec width, mêmes contraintes que width
array
Tableau d’images de référence ; lorsqu’il est fourni, passe en mode image en image
  • 1 image pour la retouche d’une image, plusieurs pour la composition de plusieurs images
string
Type d’arrière-planOptions : auto / opaque, même effet que sans ce paramètre
L’arrière-plan transparent transparent n’est pas encore disponible ; transparent ou toute autre valeur renvoie 400
auto_aspect_ratio: true et web_grounding: true ne sont pas pris en charge et renvoient 400. quality, style, output_format, response_format et mask_url ne sont pas pris en charge et sont ignorés. La sortie est toujours au format PNG.

Exemples d’utilisation

Texte en image (requête minimale) Par défaut 1:1 + 1K, sortie en 1024×1024.
Texte en image (avec ratio + 2K)
Texte en image (pixels exacts)
Retouche d’une image
Composition de plusieurs images (URL + base64 mélangés)

Response

integer
Code de statut de la réponse
array
Tableau de données de réponse

Interrogation des résultats de tâche

Après une soumission réussie, un task_id est renvoyé. Interrogez l’état de la tâche via GET /v1/tasks/{task_id}, voir API d’interrogation des tâches pour plus de détails. Nous vous recommandons d’interroger toutes les 3 à 5 secondes, avec un délai d’expiration global de 3 minutes.

Exemple de réponse en cas de succès

Accès à l’image : data.result.images[0].url[0]. Le lien de l’image expire après expires_at ; téléchargez-la et enregistrez-la dès que possible.

Statuts de tâche