Alibaba

Qwen Image 3.0

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

Prix unitaire	$0.0358

Présentation

Modèle d'édition d'image par itération à partir d'images de référence, appartenant à la série Qwen-Image 3.0. En fournissant 1 à 3 images de référence et un prompt positif décrivant les éléments à conserver et à modifier, il est possible de modifier la scène, le style, les vêtements et le texte de l'image tout en préservant les détails clés de l'image d'origine, et de produire une image en 1K ou 2K. Il convient aux développeurs qui souhaitent transformer rapidement des ressources existantes en infographies, affiches, concepts d'interface UI ou visuels de présentation de produits, en particulier dans les scénarios de production de contenu à forte densité textuelle et à exigences élevées de mise en page multilingue.

Points forts

Édition itérative à partir d'images de référence, préservation des détails — avec 1 à 3 images en entrée, modifiez la scène, le style, les vêtements et le texte selon le prompt, plutôt que de tout redessiner, ce qui facilite les itérations successives sur une même ressource.
Rendu de mises en page denses et de petits textes — conçu pour les visuels porteurs d'informations, avec une mise en page et un rendu de texte multilingue plus stables, adapté aux productions à forte densité textuelle comme les infographies et les maquettes d'interface.
Prompts capables de décrire des mises en page complexes — le prompt positif peut atteindre 18 000 caractères, suffisamment pour décrire des visuels à plusieurs éléments, des structures de mise en page et des demandes de modification localisées.
Spécifications de sortie maîtrisables — prise en charge des paliers de résolution 1K/2K, de 8 formats d'image, de la sortie png ou jpeg, de la graine aléatoire et du prompt négatif, pour des résultats faciles à intégrer dans un flux de production.

Description des capacités

Édition à partir d'images de référence : en fournissant 1 à 3 images de référence accompagnées d'un prompt, modifiez le contenu tout en préservant les informations clés de l'image d'origine ; adapté aux modifications ciblées de ressources existantes plutôt qu'à une régénération complète.

Prompts longs et contraintes négatives : le prompt positif accepte de longs textes décrivant la mise en page et les zones à conserver ou à modifier ; un prompt négatif permet en outre d'exclure les éléments indésirables, pour un contrôle précis du visuel.

Mise en page et rendu de texte : génère des visuels à la mise en page correcte contenant du texte multilingue, adapté aux productions visuelles à forte densité textuelle comme les infographies et les concepts d'interface.

Optimisation automatique du prompt : prompt_extend est activé par défaut et peut enrichir automatiquement le prompt, ce qui allège la charge de description lorsque la saisie est courte ; il peut aussi être désactivé pour conserver le texte tel quel.

Spécifications de sortie et reproductibilité : possibilité de spécifier le palier de résolution, le format d'image et le format de fichier, et de reproduire les résultats via seed, ce qui facilite la production en lot de ressources au style cohérent.

Cas d'usage

Un designer retravaille une affiche ou une infographie existante — importez l'affiche ou la maquette d'origine, ajustez le texte, le style ou la mise en page selon le prompt, et obtenez une version mise à jour directement exploitable pour la diffusion.
Une équipe produit fait évoluer des concepts d'UI — utilisez une capture d'écran d'interface existante comme image de référence, modifiez les couleurs, la mise en page ou le texte, et produisez des maquettes d'interface haute fidélité pour les revues et les discussions de prototype.
Un e-commerçant met à jour ses visuels produits — utilisez une image de produit comme référence, ajustez la scène, l'arrière-plan ou les vêtements du mannequin, et produisez des visuels produits pour les pages de détail et les supports marketing.
Localisation de supports multilingues — prenez un support en chinois ou en anglais comme image de référence, remplacez la langue et le style, et générez des visuels promotionnels adaptés à différents marchés.

Limites et conseils de sélection

Prend uniquement en charge l'édition d'image et ne dispose pas de capacité texte-vers-image ; pour générer une image à partir de texte seul, choisissez la ligne texte-vers-image de la même série. Les images de référence sont limitées à 1 à 3, chacune ne dépassant pas 10 Mo, et le format SVG n'est pas pris en charge, ce qui limite les scènes de composition complexe à plusieurs images. La lisibilité des petits textes dépend de la densité de mise en page et de la langue ; vérifiez chaque image avant la production. Ce modèle étant récent, les évaluations indépendantes publiques sont limitées ; il est conseillé de valider d'abord le rendu sur quelques échantillons avant de l'intégrer à un flux de production en lot.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour qwen-image-3.0/image-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 des résultats, sous forme d'entier ; une même graine associée aux mêmes autres paramètres permet de reproduire des résultats similaires.

promptstringRequisminLength 1maxLength 18000

Prompt positif, décrivant en texte les contenus à conserver et à modifier, sous forme de chaîne de caractères.

image_urlsarrayRequisminItems 1maxItems 3

Tableau d'URL d'images de référence, dont les éléments sont des chaînes de liens d'images, de 1 à 3 images ; formats pris en charge : JPEG, PNG, WEBP, BMP, GIF, TIFF, chaque image ne dépassant pas 10 Mo, SVG non pris en charge.

Array [ string ]

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie, sous forme de chaîne de caractères, valeur par défaut 1K.

Options：1K2K

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur-hauteur de l'image de sortie, sous forme de chaîne de caractères, valeur 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, sous forme de chaîne de caractères, valeur par défaut png.

Options：pngjpeg

prompt_extendbooleanOptionnelDéfaut: true

Indique si le prompt doit être optimisé automatiquement, sous forme de booléen, valeur par défaut true.

negative_promptstringOptionnelDéfaut: ""maxLength 500

Contenu que vous ne souhaitez pas voir apparaître dans l'image, sous forme de chaîne de caractères, valeur par défaut 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/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/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/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"
    }
  }
}