Le modèle Qwen Image Generation and Editing 3.0 prend en charge la génération d'images à partir de texte (T2I) ainsi que l'édition d'images (I2I). Il génère des images directement depuis des invites textuelles ou modifie des images existantes en s'appuyant sur une à trois images de référence accompagnées d'instructions d'édition.
Présentation du modèle
| Modèle | Description | Spécifications des images générées |
|---|---|---|
| qwen-image-3.0-pro | Modèle Qwen Image Generation and Editing 3.0 compatible avec la génération texte-vers-image (T2I) et l'édition image-vers-image (I2I). | Résolution d'image :
|
| qwen-image-3.0 | Modèle standard Qwen Image Generation and Editing 3.0 prenant en charge le T2I et l'I2I. Il offre un équilibre optimal entre qualité et rapidité. |
Disponibilité
Le modèle, l'URL de l'endpoint et la clé API doivent appartenir à la même région. Les appels interrégionaux échouent systématiquement.
- Sélectionner un modèle : Vérifiez que le modèle est disponible dans votre région cible.
- Choisir une URL : Sélectionnez l'URL d'endpoint correspondant à la région de votre modèle. Les URL HTTP et DashScope SDK sont toutes deux prises en charge.
- Configurer une clé API : Obtenez une clé API pour la région concernée, puis configurez-la comme variable d'environnement.
- Installer le SDK : Pour appeler l'API via le SDK, installez le SDK DashScope.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
HTTP
- Singapore
- China (Beijing)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation{WorkspaceId} par votre ID d'espace de travail.
Paramètres de la requête | |
En-têtes | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Valeurs disponibles : qwen-image-3.0-pro et qwen-image-3.0. | |
input object (Obligatoire)Objet contenant les paramètres d'entrée, composé des champs suivants :
Propriétés messages array (Obligatoire)Tableau du contenu de la requête. Seules les conversations à tour unique sont prises en charge, ce tableau doit donc contenir exactement un objet doté des propriétés role et content.
Propriétés role string (Obligatoire)Rôle de l'expéditeur du message. Doit être défini à user.contentarray (Obligatoire)Tableau du contenu du message, dont la combinaison varie selon le cas d'usage :
Propriétés image string (Obligatoire pour I2I)URL ou données encodées en Base64 de l'image d'entrée. Les scénarios I2I acceptent 1 à 3 images. En cas d'images multiples, leur ordre suit la séquence du tableau.Exigences relatives aux images :
string(Obligatoire)Invite positive décrivant le contenu, le style et la composition de l'image à générer ou modifier. Le chinois et l'anglais sont tous deux acceptés.Remarque : Un seul objet texte est autorisé. Son omission ou la présence de plusieurs objets texte entraînera une erreur. | |
parameters object (Facultatif)Paramètres supplémentaires permettant de contrôler la génération d'images.
Propriétés prompt_extend boolean (Facultatif)Active ou désactive la réécriture intelligente des invites. Valeur par défaut : true (recommandé). Lorsque cette option est activée, le modèle optimise l'invite positive selon la méthode définie par prompt_extend_mode, ce qui améliore considérablement les résultats pour les descriptions simples.prompt_extend_mode string (Facultatif)Méthode de réécriture de l'invite. Valeur par défaut : direct. Options disponibles :
integer (Facultatif)Nombre d'images à générer. Plage de valeurs : 1 à 6. Valeur par défaut : 1.size string (Facultatif)Résolution de l'image de sortie au format largeur hauteur, par exemple "10241024". Sans spécification, le modèle recommande automatiquement une résolution adaptée à l'invite.
string (Facultatif)Invite négative décrivant les éléments à exclure de l'image générée.seed integer (Facultatif)Graine aléatoire. Plage de valeurs : [0, 2147483647]. Une graine fixe permet d'obtenir des résultats relativement stables.watermark boolean (Facultatif)Ajoute ou non un filigrane. Valeur par défaut : false. |
Paramètres de la réponse |
Les données de la tâche (statut et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement supprimées. Pensez à enregistrer rapidement les images générées. |
output objectContient les résultats de la génération du modèle.
Propriétés choices arrayListe des options de résultats.
Propriétés finish_reason stringRaison de l'arrêt de la tâche. La valeur est stop lorsque la tâche se termine normalement.message objectMessage renvoyé par le modèle.
Propriétés role stringRôle associé au message. Valeur fixe : assistant.contentarrayContenu du message contenant les informations de l'image générée.
Propriétés image stringURL de l'image générée au format PNG. Ce lien est valide pendant 24 heures. Téléchargez et enregistrez l'image sans tarder. | |
usage objectConsommation de ressources pour cet appel. Renvoyé uniquement en cas de succès.
Propriétés output_width integerLargeur finale de l'image générée, en pixels.output_height integerHauteur finale de l'image générée, en pixels.input_image_count integerNombre d'images fournies en entrée. Renvoie 0 pour le mode texte-vers-image (T2I) et le compte réel pour le mode image-vers-image (I2I).input_image_type stringNiveau de facturation des images d'entrée. Déterminé par la surface en pixels de la résolution de sortie : qima_input_1k si la surface ≤ 2 250 000, ou qima_input_2k si la surface > 2 250 000.output_image_count integerNombre réel d'images générées et renvoyées.output_image_type stringNiveau de facturation des images de sortie. Déterminé par la surface en pixels de la résolution de sortie : qima_output_1k si la surface ≤ 2 250 000, ou qima_output_2k si la surface > 2 250 000. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Voir Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Voir Codes d'erreur. |
SDK
Les exemples suivants illustrent l'appel de l'API via les SDK Python et Java pour l'édition d'images / image-vers-image (I2I).
Python