modèles

Qwen: Qwen Image 3 Pro

Markdown · JSON

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-pro

Alibaba /qwen/qwen-image-3-pro

Premiers 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
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
qwen/qwen-image-3-pro
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limites
Longueur minimale: 1
Par défaut—
ChampresolutionTypestringExigenceFacultatifValeurs et limites
1K, 2K
Par défaut—
Champaspect_ratioTypestringExigenceFacultatifValeurs 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—
ChampnTypeintegerExigenceFacultatifValeurs et limites
Minimum: 1
Maximum: 6
Par défaut—
Champinput_referencesTypearrayExigenceFacultatifValeurs et limites
Nombre minimal d’éléments: 0
Nombre maximal d’éléments: 4
Par défaut—
ChampproviderTypeobjectExigenceFacultatifValeurs et limitesPar défaut—
Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt
Paramètrematerial_typesContrattext, 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.

ConfigurationBarème tarifaireQuantité prévisionnelleUnité de facturationCoût
ConfigurationTarifs de base par jetonBarème tarifaireTarif de baseQuantité 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éeBarème tarifaire—Quantité prévisionnelle—Unité de facturationpar image en entréeCoû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érationUnité 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

curl
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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Autres lectures de contenu
Lire les ressources existantes dont vous êtes propriétaire
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
ChampType
ChampcreatedType
Champdata[].urlType
Champdata[].b64_jsonType
ChampusageType

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

qwen/qwen-image-3-pro

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

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence