Alibaba

Qwen Image 3.0

qwen-image-3.0-pro/image-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/image-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/image-to-image per image

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

Présentation du positionnement

La voie d'édition d'image de Qwen Image 3.0 Pro permet des modifications contrôlées du visuel à partir de 1 à 3 images de référence, l'objectif étant de conserver les détails clés de l'image d'origine tout en remplaçant la scène, le style, les vêtements ou le texte de l'image. Cette solution convient aux équipes de design, d'e-commerce et de contenu qui doivent itérer plusieurs fois sur un même support : il suffit d'appeler l'API unifiée de HiAPI.ai et de décrire dans le prompt les éléments à conserver et ceux à modifier pour obtenir l'image finale, ce qui est idéal pour décliner un actif visuel existant en plusieurs versions de supports.

Points forts essentiels

Itération sur image de référence plutôt que redessin — l'édition s'appuie sur 1 à 3 images de référence comme base d'entrée et modifie le contenu spécifié tout en préservant les détails clés de l'image d'origine.
Adapté aux visuels à forte densité d'informations — le prompt peut décrire des contenus denses tels que la mise en page, les éléments et le texte, pour un résultat plus proche des livrables professionnels réels.
Spécifications de sortie contrôlables — le niveau de résolution, le rapport largeur-hauteur, le format de sortie et la graine aléatoire peuvent tous être spécifiés, ce qui facilite la production en lot de supports aux spécifications uniformes.

Description des capacités

Édition multi-références : accepte 1 à 3 images de référence, dans des formats courants tels que JPEG, PNG, WEBP, BMP, GIF, TIFF, sans dépasser 10 Mo par image ; utilisable pour des modifications ciblées de scène, de style et de vêtements.

Description des modifications par prompt long : le prompt positif peut atteindre 18 000 caractères et préciser séparément les parties à conserver et celles à modifier ; le prompt négatif contrôle indépendamment les contenus indésirables.

Ajustement de la mise en page et du texte : pour les visuels à forte densité d'éléments, il est possible d'ajuster la disposition et le contenu textuel lors de l'édition, ce qui convient pour transformer une affiche, une maquette d'interface ou une image produit existante en nouvelle version.

Contrôle des spécifications de sortie : choix entre une résolution 1K ou 2K, huit rapports largeur-hauteur et les formats de sortie png ou jpeg, avec prise en charge d'une graine fixe pour reproduire les résultats.

Optimisation automatique du prompt : l'extension du prompt est activée par défaut ; elle complète les détails de description lorsque le prompt est court, et peut être désactivée pour exécuter strictement le texte d'origine.

Cas d'usage

Refonte d'affiches et de bannières par les équipes de design — fournir une image de mise en page existante et des instructions de modification pour obtenir une nouvelle version avec des ratios de dimensions et des textes mis à jour, directement utilisable pour la diffusion et le remplacement de supports.
Transformation d'images produit par les équipes e-commerce — utiliser l'image produit existante comme référence pour remplacer l'arrière-plan, la scène ou les vêtements du mannequin, et produire plusieurs jeux de visuels de présentation pour les pages de détail et les pages d'activité.
Itération de maquettes UI — fournir un croquis d'interface ou une maquette existante, modifier la disposition et la présentation des contrôles selon le prompt, et l'utiliser comme prototype haute fidélité pour les discussions de conception.
Localisation de supports multilingues — remplacer le texte et la langue de l'image sur la base d'un même visuel source, et produire en lot des versions pour différents marchés en vue d'une diffusion localisée.

Limites et conseils de choix

Le nombre d'images de référence est limité à 3, ce qui restreint les scènes de composition complexe à partir de plusieurs images ; l'entrée SVG n'est pas prise en charge et chaque image de référence ne doit pas dépasser 10 Mo. La lisibilité de la mise en page et du texte dépend de la densité de composition et de la langue ; les petits textes denses doivent encore être vérifiés par échantillonnage. Cette voie ne fait que de l'image vers l'image ; si vous avez seulement besoin de générer une image à partir de texte, utilisez plutôt la voie texte-vers-image de la même série ; pour les tâches en lot exigeant une forte stabilité des résultats, il est recommandé de fixer la graine et de conserver la version du prompt afin de pouvoir reproduire les résultats.

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/image-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire permettant de contrôler le caractère aléatoire des résultats générés ; avec la même graine et des autres paramètres identiques, des résultats d'image similaires peuvent être reproduits.

promptstringRequisminLength 1maxLength 18000

Prompt positif, décrivant le contenu de l'image à conserver et celui à modifier ; il constitue l'entrée d'orientation principale pour l'image-vers-image.

image_urlsarrayRequisminItems 1maxItems 3

Tableau d'URL d'images de référence, définissant les images d'entrée sur lesquelles repose la génération image-vers-image ; fournir 1 à 3 images, aux formats JPEG, PNG, WEBP, BMP, GIF ou TIFF, chacune ne dépassant pas 10 Mo ; le format SVG n'est pas pris en charge.

Array [ string ]

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie, contrôlant le degré de netteté 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, contrôlant les dimensions de composition de l'image générée ; 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, contrôlant le type de fichier du résultat renvoyé ; par défaut png.

Options：pngjpeg

prompt_extendbooleanOptionnelDéfaut: true

Indique s'il faut optimiser automatiquement le prompt ; une fois activé, le modèle enrichit et peaufine le prompt saisi ; par défaut true.

negative_promptstringOptionnelDéfaut: ""maxLength 500

Prompt négatif, décrivant le contenu qui ne doit pas 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "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"
    }
  }
}