Skip to main content
POST

Autorisations

string
requis
Toutes les requêtes nécessitent une authentification Bearer Token.Visitez la page de gestion des clés API pour obtenir votre clé API, puis ajoutez-la à l’en-tête de la requête :

Modèles disponibles

La facturation est basée sur images générées avec succès × prix unitaire. L’entrée n’est pas facturée. La résolution et le rapport d’aspect n’affectent pas le prix. Les requêtes échouées ne sont pas facturées.

Body

string
requis
Nom du modèle de génération d’images.
  • wan2.7-image-pro — édition Professional, jusqu’à 4K pour le texte-vers-image
  • wan2.7-image — édition Standard, plus rapide, jusqu’à 2K
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
Description textuelle pour la génération d’images, jusqu’à 5000 caractères.
  • Texte-vers-image (sans image_urls) : obligatoire
  • Édition d’image (avec image_urls) : facultatif mais recommandé
Exemple : "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
array<string>
Tableau d’URL d’images d’entrée pour les scénarios d’édition et de référence multi-images.Fournir ce champ bascule la requête en mode édition d’image.Formats pris en charge : URL HTTP/HTTPS ; data:image/...;base64,... Base64Contraintes : jusqu’à 9 images ; JPEG / PNG / WEBP / BMP ; 240–8000 px, rapport d’aspect 1:8 ~ 8:1 ; ≤ 20 Mo par image
Le rapport d’aspect de sortie correspond automatiquement à la dernière image d’entrée. Le mode édition ne prend en charge que jusqu’à 2K — 4K n’est pas disponible.
integer
défaut:"1"
Nombre d’images à générer.
  • Mode standard : 1–4 (par défaut 1)
  • Mode séquentiel (enable_sequential: true) : 1–12 (par défaut 1)
Facturé par image générée avec succès. Pré-facturé en fonction de n.
string
Résolution de sortie ou rapport d’aspect. Prend en charge trois formats :① Mot-clé de résolution (recommandé) : 1K / 2K (par défaut) / 4K (texte-vers-image wan2.7-image-pro uniquement)② Rapport d’aspect : 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (par défaut niveau 2K)③ Dimensions en pixels : 1024x1024 ou 1024*1024
string
Mot-clé du niveau de résolution : 1K / 2K / 4K. Peut être combiné avec size (rapport d’aspect).
string
Prompt négatif décrivant les éléments à éviter. Exemple : "blurry, distorted, low quality"
boolean
défaut:"false"
Indique s’il faut ajouter un filigrane “AI Generated” dans le coin inférieur droit.
integer
Graine aléatoire, plage 0–2147483647. La même graine avec des paramètres identiques produit des résultats visuellement cohérents.
boolean
défaut:"true"
Active le mode de raisonnement amélioré pour améliorer la qualité de l’image au prix d’un temps de génération plus long.
Effectif uniquement lorsque le mode séquentiel est désactivé et qu’aucune entrée d’image n’est fournie.
boolean
défaut:"false"
Active le mode de génération séquentielle d’images — génère plusieurs images thématiquement cohérentes en une seule requête. Idéal pour les storyboards et les séries.
  • n maximum est 12 lorsqu’activé
  • thinking_mode et color_palette sont ignorés en mode séquentiel
  • wan2.7-image-pro prend en charge jusqu’à 2K en mode séquentiel (4K non pris en charge)
array
Boîtes englobantes pour l’édition interactive — spécifie les zones exactes à éditer ou dans lesquelles insérer du contenu.Structure : [[[x1, y1, x2, y2], ...], ...]
  • La longueur du tableau externe doit être égale à la longueur de image_urls
  • Passez [] pour les images sans boîte englobante
  • Maximum 2 boîtes par image ; les coordonnées sont des valeurs absolues en pixels, origine (0,0) en haut à gauche
Exemple : [[], [[989, 515, 1138, 681]]]
array<object>
Thème de couleur personnalisé. Mode standard uniquement (pas le mode séquentiel).
  • 3–10 entrées (8 recommandées) ; chaque entrée nécessite hex et ratio
  • La somme de toutes les valeurs de ratio doit être exactement égale à 100.00%

Response

string
Statut de la réponse. Retourne "success" en cas de succès.
array

Exemples

Texte-vers-image (minimal)

Texte-vers-image (avec résolution)

Texte-vers-image (palette de couleurs personnalisée)

Génération séquentielle d’images

Édition d’une seule image

Référence multi-images / fusion d’éléments

Édition interactive (boîte englobante)

bbox_list correspond 1 à 1 à image_urls. Passez [] pour les images sans sélection.
Interroger les résultatsLa génération d’images est asynchrone. Interrogez le point de terminaison Statut de tâche à l’aide du task_id retourné jusqu’à ce que status == completed.