Qwen-Image-3.0 Pro est le modèle phare de troisième génération de Qwen pour la génération et la modification d’images. Il associe création de mises en page complexes, textures réalistes détaillées, typographie multilingue et suivi précis d’une consigne visuelle. Pro et le modèle standard Qwen-Image-3.0 partagent les modes de génération et de modification documentés ; Pro privilégie la qualité d’image, tandis que l’édition standard équilibre qualité et vitesse. Le résultat est une image rendue.
Pour un visuel riche en informations, définissez le contenu avant l’apparence : titre, texte complémentaire, chiffres, hiérarchie et relations entre sections. Une consigne produit utile peut associer un objet principal, des détails de matière en gros plan et des caractéristiques étiquetées sur un même canevas. Pour une illustration pédagogique, indiquez le concept, la structure du diagramme et les légendes exactes, plutôt que de laisser le modèle inventer les faits sous-jacents. Les mises en page complexes peuvent aussi montrer plusieurs panneaux ou interfaces imbriquées. Concentrez le maximum recommandé de 4 500 tokens sur ce qui doit apparaître et sa place dans l’image.
La famille 3.0 prend en charge une typographie native dans 12 langues, plusieurs polices et plus de 100 styles artistiques, ainsi que des textures fines comme les cheveux, la peau ou le tissu. Le rendu de petits textes est démontré jusqu’à 10 pixels. Cela permet de mêler lettrage et matière physique ou texte et imagerie réaliste. Donnez les formulations exactes, les chiffres et la langue et décrivez le rôle typographique de chaque bloc. Une page de journal ou une maquette d’interface reste une image : une mise en page éditable ou un comportement interactif ultérieur est un livrable séparé à construire à partir de celle-ci.
Pro peut modifier le texte dans une image, ajouter, supprimer ou déplacer des éléments, changer l’action d’un sujet, transférer un style visuel et améliorer les détails. La modification accepte une à trois images en entrée avec une instruction. Leur ordre détermine l’image 1, l’image 2 et l’image 3 dans la consigne. Indiquez quelle référence apporte l’identité du sujet, laquelle fournit un objet ou un vêtement et laquelle contribue au décor ou à la pose. Une modification ciblée nomme le changement souhaité et les caractéristiques à préserver, facilitant la comparaison du résultat avec les références.
Les formats d’entrée pris en charge sont JPG, JPEG, PNG, BMP, TIFF, WebP et GIF. Pour un GIF animé, seule la première image de l’animation est utilisée. Chaque image en entrée peut atteindre 10 MB. L’API exacte du fabricant accepte des côtés de 1 à 8 000 pixels et un rapport entre côté long et côté court ne dépassant pas 10:1 ; sa plage recommandée est de 384–2 048 pixels. Le guide de modification recommande séparément des images allant jusqu’à 3 072 pixels : considérez le choix de l’entrée comme une préparation au détail nécessaire, pas comme la promesse que toute résolution supérieure améliore le résultat. Pour du petit texte ou des détails de matière, utilisez une référence lisible et correctement cadrée.
Les sorties sont en PNG. Le processus du fabricant renvoie une à six alternatives, une par défaut, et prend en charge une aire totale en pixels de 512 × 512 à 2 048 × 2 048 avec des rapports d’aspect de 1:8 à 8:1. Le budget d’aire autorise certaines dimensions non carrées dont le côté long dépasse 2 048 pixels. Sans taille précisée, le modèle recommande une résolution selon la consigne. Choisissez la forme pour l’emplacement réel, puis comparez les alternatives quant à la complétude du contenu, aux détails du sujet et à la typographie dans la taille d’affichage prévue.
La réécriture intelligente du prompt est activée par défaut. L’amélioration directe est disponible pour la génération et la modification ; l’amélioration par agent affine les prompts texte-vers-image et ne peut pas être utilisée pour la modification image-vers-image. Thinking est aussi activé par défaut et nécessite la réécriture du prompt ; il ajoute du raisonnement et du temps de génération. Les prompts négatifs identifient les éléments indésirables, et un seed facultatif peut rendre les comparaisons entre variantes plus cohérentes. Une consigne positive claire doit toujours définir le sujet, la composition et les détails à préserver.
Une vérification pratique contrôle le texte exact, les nombres, l’ordre de lecture, la fidélité aux références et les contours ou textures importants pour le design. Lorsqu’une partie précise nécessite une révision, conservez la composition réussie et décrivez le changement ciblé. Gardez toutes les images retenues avec leur prompt et leurs références, car les emplacements de sortie du fabricant expirent après 24 heures. Les modes et limites documentés de Pro appartiennent à l’édition 3.0 ; les dix références et la transparence native décrites pour Qwen 2.1 sont des capacités d’une édition distincte.
", "aboutText": "Qwen-Image-3.0 Pro est le modèle phare de troisième génération de Qwen pour la génération et la modification d’images. Il associe création de mises en page complexes, textures réalistes détaillées, typographie multilingue et suivi précis d’une consigne visuelle. Pro et le modèle standard Qwen-Image-3.0 partagent les modes de génération et de modification documentés ; Pro privilégie la qualité d’image, tandis que l’édition standard équilibre qualité et vitesse. Le résultat est une image rendue.\n\nPour un visuel riche en informations, définissez le contenu avant l’apparence : titre, texte complémentaire, chiffres, hiérarchie et relations entre sections. Une consigne produit utile peut associer un objet principal, des détails de matière en gros plan et des caractéristiques étiquetées sur un même canevas. Pour une illustration pédagogique, indiquez le concept, la structure du diagramme et les légendes exactes, plutôt que de laisser le modèle inventer les faits sous-jacents. Les mises en page complexes peuvent aussi montrer plusieurs panneaux ou interfaces imbriquées. Concentrez le maximum recommandé de 4 500 tokens sur ce qui doit apparaître et sa place dans l’image.\n\nLa famille 3.0 prend en charge une typographie native dans 12 langues, plusieurs polices et plus de 100 styles artistiques, ainsi que des textures fines comme les cheveux, la peau ou le tissu. Le rendu de petits textes est démontré jusqu’à 10 pixels. Cela permet de mêler lettrage et matière physique ou texte et imagerie réaliste. Donnez les formulations exactes, les chiffres et la langue et décrivez le rôle typographique de chaque bloc. Une page de journal ou une maquette d’interface reste une image : une mise en page éditable ou un comportement interactif ultérieur est un livrable séparé à construire à partir de celle-ci.\n\nPro peut modifier le texte dans une image, ajouter, supprimer ou déplacer des éléments, changer l’action d’un sujet, transférer un style visuel et améliorer les détails. La modification accepte une à trois images en entrée avec une instruction. Leur ordre détermine l’image 1, l’image 2 et l’image 3 dans la consigne. Indiquez quelle référence apporte l’identité du sujet, laquelle fournit un objet ou un vêtement et laquelle contribue au décor ou à la pose. Une modification ciblée nomme le changement souhaité et les caractéristiques à préserver, facilitant la comparaison du résultat avec les références.\n\nLes formats d’entrée pris en charge sont JPG, JPEG, PNG, BMP, TIFF, WebP et GIF. Pour un GIF animé, seule la première image de l’animation est utilisée. Chaque image en entrée peut atteindre 10 MB. L’API exacte du fabricant accepte des côtés de 1 à 8 000 pixels et un rapport entre côté long et côté court ne dépassant pas 10:1 ; sa plage recommandée est de 384–2 048 pixels. Le guide de modification recommande séparément des images allant jusqu’à 3 072 pixels : considérez le choix de l’entrée comme une préparation au détail nécessaire, pas comme la promesse que toute résolution supérieure améliore le résultat. Pour du petit texte ou des détails de matière, utilisez une référence lisible et correctement cadrée.\n\nLes sorties sont en PNG. Le processus du fabricant renvoie une à six alternatives, une par défaut, et prend en charge une aire totale en pixels de 512 × 512 à 2 048 × 2 048 avec des rapports d’aspect de 1:8 à 8:1. Le budget d’aire autorise certaines dimensions non carrées dont le côté long dépasse 2 048 pixels. Sans taille précisée, le modèle recommande une résolution selon la consigne. Choisissez la forme pour l’emplacement réel, puis comparez les alternatives quant à la complétude du contenu, aux détails du sujet et à la typographie dans la taille d’affichage prévue.\n\nLa réécriture intelligente du prompt est activée par défaut. L’amélioration directe est disponible pour la génération et la modification ; l’amélioration par agent affine les prompts texte-vers-image et ne peut pas être utilisée pour la modification image-vers-image. Thinking est aussi activé par défaut et nécessite la réécriture du prompt ; il ajoute du raisonnement et du temps de génération. Les prompts négatifs identifient les éléments indésirables, et un seed facultatif peut rendre les comparaisons entre variantes plus cohérentes. Une consigne positive claire doit toujours définir le sujet, la composition et les détails à préserver.\n\nUne vérification pratique contrôle le texte exact, les nombres, l’ordre de lecture, la fidélité aux références et les contours ou textures importants pour le design. Lorsqu’une partie précise nécessite une révision, conservez la composition réussie et décrivez le changement ciblé. Gardez toutes les images retenues avec leur prompt et leurs références, car les emplacements de sortie du fabricant expirent après 24 heures. Les modes et limites documentés de Pro appartiennent à l’édition 3.0 ; les dix références et la transparence native décrites pour Qwen 2.1 sont des capacités d’une édition distincte.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "72c6ac89ffd593474861805062344c08004f586374c9a0b3776d09b60937bcf4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "qwen/qwen-image-3-proQwen-Image-3.0 Pro est le modèle phare de Qwen pour générer et modifier des images aux mises en page complexes, détails réalistes et textes multilingues. Utilisez une consigne précise ou une à trois références pour créer un visuel, une scène de produit ou une modification ciblée.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Qwen-Image-3.0 Pro est le modèle phare de troisième génération de Qwen pour la génération et la modification d’images. Il associe création de mises en page complexes, textures réalistes détaillées, typographie multilingue et suivi précis d’une consigne visuelle. Pro et le modèle standard Qwen-Image-3.0 partagent les modes de génération et de modification documentés ; Pro privilégie la qualité d’image, tandis que l’édition standard équilibre qualité et vitesse. Le résultat est une image rendue.
Pour un visuel riche en informations, définissez le contenu avant l’apparence : titre, texte complémentaire, chiffres, hiérarchie et relations entre sections. Une consigne produit utile peut associer un objet principal, des détails de matière en gros plan et des caractéristiques étiquetées sur un même canevas. Pour une illustration pédagogique, indiquez le concept, la structure du diagramme et les légendes exactes, plutôt que de laisser le modèle inventer les faits sous-jacents. Les mises en page complexes peuvent aussi montrer plusieurs panneaux ou interfaces imbriquées. Concentrez le maximum recommandé de 4 500 tokens sur ce qui doit apparaître et sa place dans l’image.
La famille 3.0 prend en charge une typographie native dans 12 langues, plusieurs polices et plus de 100 styles artistiques, ainsi que des textures fines comme les cheveux, la peau ou le tissu. Le rendu de petits textes est démontré jusqu’à 10 pixels. Cela permet de mêler lettrage et matière physique ou texte et imagerie réaliste. Donnez les formulations exactes, les chiffres et la langue et décrivez le rôle typographique de chaque bloc. Une page de journal ou une maquette d’interface reste une image : une mise en page éditable ou un comportement interactif ultérieur est un livrable séparé à construire à partir de celle-ci.
Pro peut modifier le texte dans une image, ajouter, supprimer ou déplacer des éléments, changer l’action d’un sujet, transférer un style visuel et améliorer les détails. La modification accepte une à trois images en entrée avec une instruction. Leur ordre détermine l’image 1, l’image 2 et l’image 3 dans la consigne. Indiquez quelle référence apporte l’identité du sujet, laquelle fournit un objet ou un vêtement et laquelle contribue au décor ou à la pose. Une modification ciblée nomme le changement souhaité et les caractéristiques à préserver, facilitant la comparaison du résultat avec les références.
Les formats d’entrée pris en charge sont JPG, JPEG, PNG, BMP, TIFF, WebP et GIF. Pour un GIF animé, seule la première image de l’animation est utilisée. Chaque image en entrée peut atteindre 10 MB. L’API exacte du fabricant accepte des côtés de 1 à 8 000 pixels et un rapport entre côté long et côté court ne dépassant pas 10:1 ; sa plage recommandée est de 384–2 048 pixels. Le guide de modification recommande séparément des images allant jusqu’à 3 072 pixels : considérez le choix de l’entrée comme une préparation au détail nécessaire, pas comme la promesse que toute résolution supérieure améliore le résultat. Pour du petit texte ou des détails de matière, utilisez une référence lisible et correctement cadrée.
Les sorties sont en PNG. Le processus du fabricant renvoie une à six alternatives, une par défaut, et prend en charge une aire totale en pixels de 512 × 512 à 2 048 × 2 048 avec des rapports d’aspect de 1:8 à 8:1. Le budget d’aire autorise certaines dimensions non carrées dont le côté long dépasse 2 048 pixels. Sans taille précisée, le modèle recommande une résolution selon la consigne. Choisissez la forme pour l’emplacement réel, puis comparez les alternatives quant à la complétude du contenu, aux détails du sujet et à la typographie dans la taille d’affichage prévue.
La réécriture intelligente du prompt est activée par défaut. L’amélioration directe est disponible pour la génération et la modification ; l’amélioration par agent affine les prompts texte-vers-image et ne peut pas être utilisée pour la modification image-vers-image. Thinking est aussi activé par défaut et nécessite la réécriture du prompt ; il ajoute du raisonnement et du temps de génération. Les prompts négatifs identifient les éléments indésirables, et un seed facultatif peut rendre les comparaisons entre variantes plus cohérentes. Une consigne positive claire doit toujours définir le sujet, la composition et les détails à préserver.
Une vérification pratique contrôle le texte exact, les nombres, l’ordre de lecture, la fidélité aux références et les contours ou textures importants pour le design. Lorsqu’une partie précise nécessite une révision, conservez la composition réussie et décrivez le changement ciblé. Gardez toutes les images retenues avec leur prompt et leurs références, car les emplacements de sortie du fabricant expirent après 24 heures. Les modes et limites documentés de Pro appartiennent à l’édition 3.0 ; les dix références et la transparence native décrites pour Qwen 2.1 sont des capacités d’une édition distincte.
POST /v1/images/generationstext, imageimage| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites qwen/qwen-image-3-pro | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 1K, 2K | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 6 | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 4 | Par défaut— |
Champprovider | Typeobject | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètrematerial_types | Contrattext, image |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Unité de facturation | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Unité de facturation— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| Configurationimage d’entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image en entrée | Coût Entrée · image d’entrée · Estimation à des fins de comparaison uniquement $0.006 par image en entrée |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Unité de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.08 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nTéléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nEnregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Conservez le X-Client-Request-ID renvoyé pour le rapprochement. Consultez uniquement les valeurs task_id/asset_id effectivement renvoyées ou votre bibliothèque multimédia ; ne construisez jamais une URL de tâche à partir de l’identifiant de l’opération et ne soumettez jamais à nouveau la création.
| Champ | Type |
|---|---|
Champcreated | Type |
Champdata[].url | Type |
Champdata[].b64_json | Type |
Champusage | Type |
Ailoot Ultra qwen/qwen-image-3-pro
/v1/images