Alibaba

Wan 2.7 Image

wan2.7-image-standard

Modèle de génération et d'édition d'images lancé par Alibaba, qui intègre la génération texte-image, la combinaison de plusieurs images de référence et l'édition par instructions dans un même flux de travail, avec prise en charge du rendu de textes longs et du contrôle des couleurs de marque

wan2.7-image-standard wan2.7-image/text-to-image

Essayer wan2.7-image-standard

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

wan2.7-image-standard per image

Spécifications	Prix unitaire
1K	$0.0345
2K	$0.0345

Présentation

Wan 2.7 Image Standard est un modèle de génération et d’édition d’images lancé par Alibaba, qui met à disposition des capacités de génération d’images à partir de texte et à partir d’images via l’interface unifiée de HiAPI.ai. Il prend en charge jusqu’à 9 images de référence en entrée, deux niveaux de résolution 1K/2K, plusieurs formats d’image et le contrôle par graine aléatoire ; il convient aux développeurs ayant besoin de productions visuelles complètes ou de modifier des images sur instruction, pour des supports de marque, des catalogues e-commerce et du design conceptuel.

Points clés

Génération à partir de texte et édition par images de référence unifiées — le même modèle peut générer une image directement à partir d’un texte ou combiner jusqu’à 9 images de référence, ou les modifier sur instruction, ce qui limite les changements d’outil.
Cohérence maintenue grâce à plusieurs images de référence — jusqu’à 9 images accessibles publiquement peuvent servir de référence ; le format de sortie suit la dernière image de référence, ce qui facilite la production de séries visuelles cohérentes.
Résolution et format paramétrables — sortie 1K ou 2K au choix ; en génération à partir de texte, plusieurs formats de 1:1 à 8:1 sont pris en charge pour adapter les dimensions aux emplacements d’affichage.

Capacités

Génération à partir de texte : génère une image à partir d’une simple invite textuelle, avec choix du niveau de résolution et du format ; l’invite peut comporter jusqu’à 5000 caractères, ce qui permet d’obtenir directement une image exploitable à partir d’une description conceptuelle.

Édition par instruction sur image de référence : fournissez l’URL publique d’une image de référence ou d’une image à modifier, décrivez la modification en langage naturel ; le modèle renvoie l’image éditée, dont le format suit la dernière image de référence.

Combinaison de plusieurs images de référence : accepte jusqu’à 9 images de référence, chacune ne dépassant pas 20 Mo, aux formats JPEG, PNG, BMP et WebP ; les éléments visuels de plusieurs images de référence peuvent être fusionnés dans une seule sortie.

Contrôle de la résolution et de la graine : niveau de sortie 1K ou 2K au choix ; une graine aléatoire comprise entre 0 et 2147483647 permet d’obtenir des résultats relativement stables pour les mêmes entrées, ce qui facilite la reproductibilité et les itérations par lots.

Cas d’usage

Équipes marketing : production de supports visuels cohérents pour une campagne — saisissez une description de marque et plusieurs images de référence stylistiques pour produire des bannières, illustrations et autres éléments d’un ton uniforme, destinés aux pages d’atterrissage et aux réseaux sociaux.
E-commerce : création d’images produit et de mises en situation — téléversez des photos de produits et décrivez les changements de scène souhaités pour obtenir des visuels produit conformes aux normes d’affichage, destinés aux fiches produit et aux créations publicitaires.
Designers : génération de croquis conceptuels et de storyboards — générez des croquis de storyboard et des concept arts de personnages à partir de descriptions textuelles ou d’images de référence, pour les discussions de projet en amont et la réalisation de storyboards.
Développeurs : intégration d’API de génération d’images par lots — appelez le modèle via l’interface unifiée de HiAPI.ai pour intégrer la génération à partir de texte ou d’images dans vos propres workflows et produire à la demande des ressources visuelles en 1K/2K.

Limites et conseils de sélection

La version Standard limite la résolution de sortie à 1K et 2K et ne propose pas de niveau supérieur ; pour une résolution plus élevée ou une stabilité de composition renforcée, envisagez la version Pro de la même série. Les images de référence doivent être accessibles via une URL publique et ne pas dépasser 20 Mo chacune ; après ajout d’images de référence, le format est déterminé par la dernière image de référence et ne peut plus être spécifié par paramètre. Une graine fixe ne rend les résultats que relativement stables, sans garantir une reproduction parfaite. Pour les cas impliquant une mise en page de textes longs ou un contrôle précis des couleurs de marque, il est recommandé de valider l’effet sur un petit lot d’échantillons avant d’élargir l’usage.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Mise en ligne du modèle de génération d'images wan2.7-image-standard Nov 3, 2026

Questions fréquentes

Voir toutes les questions →

Quels formats d'image spéciaux Wan 2.7 Image prend-il en charge ?

Outre les formats paysage et portrait courants, il prend également en charge des formats ultra-larges ou ultra-hauts tels que 21:9, 8:1 et 1:8.
À quoi sert le mode Thinking ?

Une fois activé, il augmente le temps de génération afin de renforcer le raisonnement et l'organisation visuelle pour les prompts complexes ; pour un brouillon rapide, il vaut mieux le laisser désactivé.
Comment choisir entre 1K, 2K et 4K ?

Commencez par valider la direction avec 1K ou 2K, puis passez à 4K lorsque vous avez besoin d'un rendu final plus grand. Les prix affichés sur cette page correspondent à un tarif fixe par image.
Le modèle prend-il en charge les images de référence ?

L'ID de modèle actuel correspond à une approche de génération d'images purement textuelle et n'accepte pas les images de référence.

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 : wan2.7-image-standard

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour wan2.7-image-standard et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire, valeur de 0 à 2147483647 ; une graine fixe permet d'obtenir des résultats relativement stables, si non fournie la valeur est aléatoire.

promptstringRequisminLength 1maxLength 5000

Décrit l'image à générer, ou précise les modifications à apporter à l'image de référence ; en chinois ou en anglais, 5000 caractères maximum.

image_urlsarrayOptionnelminItems 1maxItems 9

Tableau d'URL publiques d'images de référence ou d'images à éditer, 9 images maximum ; si non fourni, il s'agit d'une génération texte-vers-image ; prend en charge JPEG, PNG, BMP, WebP, chaque image ne dépassant pas 20 Mo, avec un côté de 240 à 8000 pixels et un rapport largeur-hauteur de 1:8 à 8:1. Lorsque des images sont fournies, le format de sortie suit la dernière image de référence.

Array [ string ]

resolutionstringOptionnelDéfaut: "2K"

Niveau de résolution de sortie, 1K ou 2K au choix ; 1K correspond à environ 1024² et 2K à environ 2048² en nombre total de pixels ; 2K par défaut.

Options：1K2K

aspect_ratiostringOptionnelDéfaut: "1:1"

Format de l'image de sortie, effectif uniquement lorsqu'aucune image de référence n'est téléversée ; après téléversement d'une image de référence, le format est déterminé par celle-ci et aucun réglage n'est nécessaire. 1:1 par défaut.

Options：1:116:94:321:93:49:168:11:8

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": "wan2.7-image-standard",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

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: "wan2.7-image-standard",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
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": "wan2.7-image-standard",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}