API Qwen-Image 3.0

Générez ou modifiez une image via GoEnhance avec le modèle qwen-image-3. Utilisez un prompt seul pour la génération texte-image, ou ajoutez une à trois URL de référence pour l'édition d'image. GoEnhance fournit un accès API indépendant ; il ne s'agit pas d'une API officielle d'Alibaba et GoEnhance n'est pas une société affiliée à Alibaba.
Créer une clé API
Scène de studio abstraite représentant la génération via l'API Qwen-Image 3.0

Réunir génération et édition dans un seul flux

Un endpoint, deux modes

Envoyez une requête POST à /api/v1/images/generations avec model: qwen-image-3. Fournissez uniquement un prompt pour la génération texte-image, ou incluez une à trois URL d'images de référence accessibles pour l'édition. Chaque requête renvoie une image.
Objets d'art en verre dans une même scène de studio évoquant la génération et l'édition d'images

Des résultats asynchrones par conception

Une soumission réussie renvoie un img_uuid. Conservez-le, interrogez GET /api/v1/jobs/detail en polling, ou indiquez une URL de callback HTTPS publique pour recevoir les changements de statut processing, success et failed.
Couloir de données sans marque avec une traînée lumineuse continue évoquant la livraison asynchrone
Vérifiez les champs documentés avant de soumettre une tâche de génération ou d'édition.

Paramètres de l'API Qwen-Image 3.0

ID du modèle

Définissez model sur la valeur exacte qwen-image-3.

Prompt

Indiquez de 1 à 2000 caractères décrivant l'image ou la retouche souhaitée.

Format d'image

Utilisez auto ou un ratio documenté allant de 1:1 jusqu'à 1:8 et 8:1.

Niveau de sortie

Choisissez 1K ou 2K ; la valeur par défaut documentée est 2K.

Images de référence

Vous pouvez fournir une à trois URL d'images, chacune de moins de 10 MB, pour l'édition.

Contrôles du prompt

Vous pouvez définir un prompt négatif, une graine et le mode d'extension direct ou agent.
Le tarif repose sur la sortie, augmentée du supplément éventuel pour images de référence.

Tarifs de l'API Qwen-Image 3.0

Tarif de sortie

Chaque sortie en 1K ou 2K coûte 1.75 tokens, soit $0.035 par image générée.

Supplément par référence

Chaque image de référence ajoute 0.19 token, soit $0.0039 par image de référence.

Calcul d'une tâche

Une requête avec deux références coûte 2.13 tokens : 1.75 + (2 × 0.19).

Intégrer l'API Qwen-Image 3.0

1

Construire la requête

Transmettez votre identifiant API dans l'en-tête Authorization, puis envoyez en POST un corps JSON contenant model et prompt. N'ajoutez le ratio, la taille d'image ou les URL de référence qu'en cas de besoin.
2

Conserver l'ID de tâche

Vérifiez la présence de code: 0 et stockez l'img_uuid renvoyé. Traitez les réponses de tokens insuffisants et d'authentification comme des échecs, et non comme des résultats d'image.
3

Confirmer la fin de la tâche

Interrogez l'endpoint de détail du job en polling ou utilisez un callback HTTPS public. N'acceptez le fichier qu'une fois la tâche passée à success, et traitez explicitement le statut failed.
Créer une clé API
Ajoutez la génération d'images et les retouches contrôlées à vos workflows de production sans construire votre propre infrastructure de service de modèles.

Cas d'usage pour les développeurs

Visuels produit

Créez des concepts produit prêts pour la campagne à partir de prompts structurés.

Variations créatives

Générez de nouvelles pistes visuelles pour les publicités, les publications et les landing pages.

Retouches guidées par référence

Transformez une à trois références fournies tout en préservant l'intention du prompt.

Campagnes localisées

Produisez des concepts visuels par marché à partir de briefs créatifs localisés.

Pipelines d'assets

Mettez en file d'attente des jobs de génération asynchrones dans des workflows de contenu automatisés.

Prototypage de design

Explorez des idées de composition, de matière et de couleur avant la production finale.
Réponses aux questions fréquentes sur les tarifs, les entrées et l'intégration.

FAQ sur l'API Qwen-Image 3.0

Quel est l'endpoint de l'API Qwen-Image 3.0 ?

Envoyez des requêtes POST à https://api.goenhance.ai/api/v1/images/generations avec model: qwen-image-3.

Combien coûte l'API Qwen-Image 3.0 ?

Le tarif de sortie documenté est de 1.75 tokens, soit $0.035, aussi bien en 1K qu'en 2K. Chaque image de référence ajoute 0.19 token, soit $0.0039.

L'API peut-elle modifier des images existantes ?

Oui. Ajoutez image_list avec une à trois URL d'images accessibles, chacune de moins de 10 MB. Omettez ce champ pour une génération texte-image pure.

Quels formats d'image sont pris en charge ?

L'API prend en charge auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8 et 8:1. Les sorties en 1:8 et 8:1 sont limitées au niveau 1K.

Comment fonctionnent les callbacks ?

Indiquez une URL de callback HTTPS accessible publiquement. GoEnhance envoie les changements processing, success et failed au format de la réponse de détail du job. Les callbacks qui ne renvoient pas 200 font l'objet de trois tentatives au maximum, avec un délai d'attente de trois secondes par tentative.

S'agit-il d'une API officielle d'Alibaba ?

Non. Qwen est associé à Alibaba, tandis que cet endpoint est fourni de façon indépendante par GoEnhance. Cela n'implique ni partenariat avec Alibaba ni approbation de sa part. Pour un service exploité par Alibaba, consultez la documentation d'Alibaba Cloud.

Commencez à développer avec Qwen-Image 3.0