Alibaba

Qwen Image 3.0

qwen-image-3.0-pro/text-to-image

Modèle de génération et d'édition d'images de troisième génération d'Ali, excellent dans la composition dense et le rendu multilingue sous de longs prompts, avec prise en charge de l'édition à partir d'images de référence

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

Essayer qwen-image-3.0-pro/text-to-image

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

qwen-image-3.0-pro/text-to-image per image

Spécifications	Prix unitaire
1K	$0.0497
2K	$0.0993

Positionnement et présentation

Qwen Image 3.0 Pro est un modèle de génération d'images à partir de texte de la série Qwen d'Alibaba, centré sur la production d'images véhiculant de véritables informations : une seule image peut organiser un contenu dense comme des infographies, des mises en page de journal, des maquettes d'interface, des grilles de produits, et afficher du texte multilingue correctement disposé. Il s'adresse aux développeurs qui doivent transformer de manière fiable de longs prompts en ressources visuelles exploitables, et convient à la génération d'images en lot pour les applications de design, de contenu, d'e-commerce et d'éducation.

Points forts

Les prompts longs prennent en charge des mises en page complexes — la limite du prompt est de 18 000 caractères, suffisamment pour décrire une mise en page multi-blocs, sa hiérarchie et le texte de chaque bloc.
Le rendu du texte et de la mise en page est au cœur du modèle — conçu pour générer des images riches en éléments et contenant du texte, ce qui réduit les retouches consistant à ajouter et composer le texte après génération.
Des paramètres contrôlables couvrent les besoins courants de génération — prise en charge du rapport largeur/hauteur, des résolutions 1K/2K, des formats png/jpeg, du prompt négatif et de la reproductibilité via seed.

Description des capacités

Génération à partir de prompts longs : la description complète de l'image est transmise via le champ prompt, qui accepte de longues descriptions de mise en page et d'éléments ; un seul appel produit directement l'image finale, ce qui réduit l'assemblage étape par étape.

Résolution et rapport largeur/hauteur contrôlés : resolution peut valoir 1K ou 2K, et aspect_ratio couvre 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 et 21:9, ce qui permet de générer directement aux dimensions correspondant à l'emplacement de diffusion.

Optimisation automatique du prompt et contraintes négatives : prompt_extend est activé par défaut et peut compléter et optimiser automatiquement le prompt ; negative_prompt sert à exclure les contenus non souhaités et améliore la stabilité de la génération.

Reproductibilité par graine aléatoire : le paramètre seed est disponible ; une graine comprise entre 0 et 2147483647 permet de reproduire le même résultat, ce qui facilite la comparaison des réglages et la stabilité des pipelines par lots.

Sortie directe au format souhaité : output_format prend en charge png et jpeg ; choisissez directement le format de fichier selon l'usage en aval, sans étape de transcodage supplémentaire.

Cas d'usage

Équipes de contenu : générer des affiches et des mises en page à partir de textes longs — indiquez les titres, le corps du texte et les exigences de mise en page dans le prompt pour produire des affiches ou des mises en page façon journal contenant du texte, directement utilisables pour la publication et les supports marketing.
Développeurs designers : génération de maquettes d'interface — générez des concepts d'UI et des maquettes haute fidélité aux formats 16:9 ou 9:16, comme référence visuelle pour la revue produit et l'intégration front-end.
E-commerce : création d'images de présentation de produits — générez des grilles de produits et des visuels aux formats 1:1 ou 4:3, et produisez en lot, avec un seed fixe, des supports marketing au style homogène.
Éducation : supports pédagogiques mêlant textes et images — décrivez la structure des points de connaissance avec de longs prompts et générez des illustrations associant textes et images, pour illustrer supports de cours et documents de formation.

Limites et conseils de choix

Le modèle est positionné sur la production visuelle informative : les images sont denses en éléments et contiennent du texte, et il ne constitue pas le premier choix pour des illustrations ou des créations artistiques purement esthétiques. Les prompts doivent préciser clairement la mise en page et le contenu textuel, ce qui exige une bonne capacité de description ; la composition complexe à partir de plusieurs images de référence n'entre pas dans le périmètre de cette offre (qui ne couvre que la génération d'images à partir de texte). Les résultats dépendent de la densité de mise en page et de la langue ; avant une génération en lot, il convient de valider sur un petit échantillon et de contrôler la stabilité au moyen d'un seed fixe et de prompts négatifs.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle disponible : qwen-image-3.0-pro/text-to-image Oct 31, 2026
Nouveau modèle Le modèle image-to-image qwen-image-3.0-pro est disponible Oct 31, 2026
Nouveau modèle Ajout de qwen-image-3.0/text-to-image… Aug 20, 2026

Questions fréquentes

Voir toutes les questions →

Combien d'images de référence la retouche d'image Qwen Image 3.0 prend-elle en charge ?

Prend en charge 1 à 3 images de référence. Au moins une est requise, le champ API est input.image_urls.
Quelle est la différence entre l'édition d'image Standard et Pro ?

La version Standard privilégie un coût réduit et des itérations rapides ; la version Pro est plus adaptée au remplacement précis de texte, aux textures complexes et à la mise en page finale.
Comment sont facturés le 1K, le 2K et les images de référence ?

Le 1K et le 2K utilisent le même palier de sortie ; chaque image de référence est facturée en supplément. Les montants exacts sont ceux du tarif en temps réel affiché sur cette page.
Comment réduire la dérive du sujet, de la mise en page ou du texte ?

Dans le prompt, énumérez séparément les éléments à modifier et ceux à conserver impérativement : sujet, texte, position, matière, angle de prise de vue et éclairage ; lorsque le texte doit être exact, écrivez le texte cible entre guillemets.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : qwen-image-3.0-pro/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour qwen-image-3.0-pro/text-to-image et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire utilisée pour contrôler le caractère aléatoire de la génération ; la valeur est un entier, une même graine permet de reproduire des résultats de génération similaires.

promptstringRequisminLength 1maxLength 18000

Prompt positif : décrit sous forme de chaîne le contenu, le style et la composition de l'image souhaitée ; c'est la base principale de la génération d'image.

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie : spécifie sous forme de chaîne le niveau de résolution de l'image générée, par défaut 1K.

Options：1K2K

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur/hauteur de l'image de sortie, spécifié sous forme de chaîne, par défaut 1:1.

Options：1:13:22:34:33:416:99:1621:9

output_formatstringOptionnelDéfaut: "png"

Format de fichier de l'image générée, spécifié sous forme de chaîne, par défaut png.

Options：pngjpeg

prompt_extendbooleanOptionnelDéfaut: true

Indique s'il faut optimiser automatiquement le prompt, valeur booléenne, par défaut true ; une fois activé, le prompt saisi est automatiquement développé et optimisé.

negative_promptstringOptionnelDéfaut: ""maxLength 500

Prompt négatif : décrit sous forme de chaîne le contenu que l'on ne souhaite pas voir apparaître dans l'image, par défaut une chaîne vide.

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0-pro/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-3.0-pro/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-image-3.0-pro/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}