Qwen: Qwen Image 3 Pro
Qwen-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.
À propos du modèle
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é même à une taille de 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.
Ailoot Ultra · Génération d’images POST /v1/images/generations qwen/qwen-image-3-pro
qwen/qwen-image-3-proPremiers pas
Qwen-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.
- Entrées acceptées
- Texte · Images
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Génération d’images POST /v1/images/generations
- Types d’entrée
text,image- Types de sortie
image
| 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ètres et cycle de vie de la méthode
| 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}
Tarifs
Calcul du coût final
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.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
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 par jeton | 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 en entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image en entrée | Coût Entrée · image en entrée · Estimation à des fins de comparaison uniquement $0.006 par image en entrée |
| ConfigurationCoût de génération estimé | 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 →
Exemples de requêtes
Ailoot Ultra · Génération d’images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · Génération d’images
Té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}
Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserver tous les résultats terminés
Enregistrez 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.
Si la réponse d’origine doit être vérifiée
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.
Champs de la réponse
| Champ | Type |
|---|---|
Champcreated | Type |
Champdata[].url | Type |
Champdata[].b64_json | Type |
Champusage | Type |
Alias
Alias du modèle
Ailoot Ultra qwen/qwen-image-3-pro
Alias des chemins de méthode
/v1/images
ID d’appel associés
FAQ · Qwen: Qwen Image 3 Pro
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/images/generations·qwen/qwen-image-3-pro:text,image→image- Quels champs la requête utilise-t-elle ?
POST /v1/images/generations·qwen/qwen-image-3-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Quelles limites s’appliquent ?
POST /v1/images/generations·qwen/qwen-image-3-pro:n.minimum:1;n.maximum:6