Alibaba

Qwen Image 2.1

qwen-image-2.1-pro

Modèle d'image unifié pour la génération texte-image et l'édition d'images, prenant nativement en charge la résolution 2K et la sortie RGBA avec un véritable canal alpha, permettant de désigner plusieurs zones d'édition à l'aide de cercles, d'annotations manuscrites ou de masques

qwen-image-2.1-pro qwen-image-2.1-turbo

Tarifs

qwen-image-2.1-pro per image

Prix unitaire	$0.050

Présentation du positionnement

Qwen Image 2.1 Pro est le niveau haut de gamme de la série de modèles d'image de l'équipe Qwen d'Alibaba, appelé via l'interface unifiée de HiAPI.ai ; un même modèle prend en charge à la fois la génération d'images à partir de texte et l'édition d'images. Il peut réaliser des modifications de couleur, des remplacements, des retouches locales et d'autres éditions à partir de 1 à 10 images de référence, ou générer une image purement à partir de texte ; la sortie prend en charge plusieurs formats d'image de 1:1 à 9:16, et il est possible de fixer le résultat avec une graine et de contrôler un fond transparent via le prompt. Il convient aux processus produits et de design nécessitant des images finales de haute précision et une édition à partir de plusieurs images de référence.

Points clés

Un seul modèle pour la génération et l'édition — pas besoin de basculer les poids du modèle entre la génération texte-vers-image et image-vers-image ; une seule chaîne d'appel couvre les deux types de tâches.
Jusqu'à 10 images de référence référencées dans l'ordre — les entrées multi-images sont numérotées selon l'ordre du tableau et peuvent être citées précisément dans le prompt par « image 1 », « image 2 », ce qui facilite la composition de multiples éléments et l'édition cohérente.
Graine reproductible pour faciliter la validation par régression — une graine aléatoire fixée entre 0 et 2147483647 permet d'obtenir des résultats relativement stables, adaptés aux flux par lots et au débogage nécessitant des images répétées.
Extension automatique du prompt avec commutateur optionnel — prompt_extend est activé par défaut, ce qui améliore nettement les prompts courts ; lorsqu'une mise en page stricte selon le texte d'origine est requise, il peut être désactivé pour préserver le sens d'origine.

Description des capacités

Génération texte-vers-image et édition d'image unifiées : un même modèle peut à la fois générer une image à partir d'un prompt et modifier une image de référence selon un prompt, réduisant la fragmentation de style et de processus liée à l'enchaînement de plusieurs modèles.

Entrée multi-images de référence : prend en charge 1 à 10 images accessibles publiquement, numérotées selon l'ordre du tableau et citées dans le prompt, utilisables pour la fusion de multiples éléments et l'édition par zones.

Sortie multi-formats : cinq formats au choix — 1:1, 16:9, 9:16, 4:3 et 3:4 — correspondant à des dimensions maximales telles que 2688×1536 ; si aucun n'est fourni, le modèle choisit automatiquement selon le prompt et les images de référence.

Contrôle du fond transparent : il suffit d'indiquer « fond transparent » dans le prompt pour générer une image à fond transparent, évitant l'étape ultérieure de détourage.

Résultats reproductibles : le paramètre seed fixe la graine aléatoire, permettant d'obtenir une sortie relativement stable avec les mêmes entrées, ce qui facilite la génération par lots et la régression des effets.

Scénarios d'application

Retouche de visuels pour les équipes e-commerce et design — téléversez des images de référence de produits ou de mannequins, puis spécifiez par prompt des modifications telles que le changement de couleur ou le remplacement de zones de vêtements, pour obtenir des images finales directement utilisables sur les pages de détail et les supports publicitaires.
Visuels de marque composés de multiples éléments — saisissez plusieurs images de référence et citez-les dans l'ordre pour générer une composition visuelle au style unifié, destinée aux affiches, aux visuels de réseaux sociaux et aux supports d'événements.
Icônes et images de produits nécessitant un fond transparent — demandez un fond transparent dans le prompt pour produire directement des ressources d'image superposables à une interface ou à un calque de composition, réduisant les étapes de post-traitement.
Pipeline automatisé de génération par lots — fixez la graine et les paramètres de format, intégrez les appels de génération ou d'édition dans la chaîne de production de contenu pour une sortie stable d'images sérielles.

Limites et conseils de sélection

Ce modèle est le niveau haut de gamme de la série ; le temps et le coût de génération par image sont supérieurs à ceux du niveau turbo de la même série, ce qui le destine aux scénarios exigeant une haute qualité d'image finale ; pour les aperçus à grande échelle ou une présélection à faible coût, le niveau turbo peut être envisagé. Les images de référence d'entrée doivent être des URL accessibles publiquement, ne pas dépasser 10 Mo chacune, avec un rapport entre le côté long et le côté court ne dépassant pas 10:1. Le prompt est limité à 4500 caractères ; lorsqu'une mise en page stricte selon le texte d'origine est requise, il est conseillé de désactiver l'extension automatique. Si la tâche privilégie une latence extrêmement faible ou ne nécessite qu'une simple génération par lots, il convient d'évaluer des options plus légères.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire, entier de 0 à 2147483647 ; fixer cette valeur permet d'obtenir des résultats de génération relativement stables ; si elle n'est pas transmise, la génération est aléatoire.

promptstringRequisminLength 1maxLength 4500

Décrit le contenu de l'image à générer, ou précise les modifications à apporter à l'image de référence ; le chinois comme l'anglais sont acceptés ; le texte à afficher doit être écrit mot pour mot dans le prompt ; pour un fond transparent, indiquez « fond transparent » dans le prompt.

image_urlsarrayOptionnelminItems 1maxItems 10

Tableau d'URL publiques d'images de référence ou d'images à retoucher, de 1 à 10 ; si aucune n'est transmise, il s'agit d'une génération texte-vers-image ; les images multiples sont numérotées dans l'ordre du tableau (on peut les désigner par « image 1 », « image 2 »). Formats pris en charge : JPG, JPEG, PNG, BMP, TIFF, WEBP, GIF ; chaque image ne doit pas dépasser 10 Mo, avec une largeur et une hauteur comprises entre 1 et 8000 pixels (384–2048 recommandé), et un rapport entre le grand côté et le petit côté ne dépassant pas 10:1.

Array [ string ]

aspect_ratiostringOptionnel

Format de sortie, valeur de type chaîne, correspondant à des dimensions telles que 2048×2048, 2688×1536, 1536×2688, 2368×1728, 1728×2368 ; si elle n'est pas transmise, le modèle choisit automatiquement en fonction du prompt et de l'image de référence.

Options：1:116:99:164:33:4

prompt_extendbooleanOptionnelDéfaut: true

Indique s'il faut optimiser automatiquement le prompt, valeur booléenne, par défaut true ; une fois activé, l'amélioration est nette pour les prompts courts, mais cela ajoute quelques secondes de traitement ; on peut le désactiver lorsqu'une mise en page strictement conforme au texte original est requise.

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-2.1-pro",
  "input": {
    "prompt": "…",
    "prompt_extend": true
  }
}'

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-2.1-pro",
    input: {
      "prompt": "…",
      "prompt_extend": true
    }
  }),
});
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-2.1-pro",
        "input": {
          "prompt": "…",
          "prompt_extend": True
        }
    },
)
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"
    }
  }
}