Alibaba

Z-Image

z-image

Modèle de génération d'images à partir de texte open source d'Alibaba Tongyi, architecture DiT à flux unique d'environ 6 milliards de paramètres, remarquable pour le rendu de texte en chinois et en anglais et le respect d'instructions bilingues

z-image

Essayer z-image

Entrée

Créations

Voir toutes les créations

Sortie

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

Tarifs

z-image per image

Prix unitaire	$0.008

Présentation

z-image est un modèle de génération d'images à partir de texte lancé par le laboratoire Tongyi d'Alibaba. Il est accessible via l'interface unifiée de HiAPI.ai et permet de générer des images réalistes ou artistiques à partir d'invites en chinois ou en anglais, tout en gérant la composition typographique de textes chinois et anglais dans l'image. Il convient aux développeurs qui ont besoin de produire rapidement des visuels créatifs, des affiches et des illustrations stylisées, ainsi qu'aux scénarios d'évaluation d'intégration portant sur les capacités des modèles open source.

Points clés

Invites bilingues chinois-anglais et rendu de texte dans l'image — les invites acceptent le chinois et l'anglais, et le texte chinois ou anglais peut être rendu dans l'image générée, ce qui facilite la création de supports visuels accompagnés de textes.
Architecture DiT à flux unique, haute efficacité paramétrique — les conditions de texte et d'image sont modélisées de manière unifiée au niveau de la séquence, permettant d'obtenir une qualité visuelle exploitable avec un nombre de paramètres réduit.
Plusieurs formats d'image sélectionnables en une fois — la sortie prend en charge cinq ratios largeur-hauteur : 1:1, 4:3, 3:4, 16:9 et 9:16, couvrant les besoins de diffusion en carré, en paysage et en portrait.
Génération d'images légère facturée à l'image — l'interface facture selon le nombre d'images générées ; l'invite et le ratio largeur-hauteur sont les seuls éléments d'entrée, ce qui simplifie l'intégration et le calcul des coûts.

Description des capacités

Génération d'images à partir de texte en chinois et en anglais : il suffit de saisir une invite en chinois ou en anglais de 1000 caractères maximum pour générer une image, ce qui convient à la validation rapide de pistes créatives ou à la production par lots de visuels d'illustration.

Rendu de texte dans l'image : le texte chinois ou anglais peut être intégré dans l'image, ce qui convient à la création de visuels avec titre ou slogan et réduit les retouches typographiques ultérieures.

Contrôle du ratio largeur-hauteur : aspect_ratio permet de spécifier l'un des cinq formats, avec 1:1 par défaut, pour répondre directement aux exigences de composition des différents emplacements de diffusion.

Rendu réaliste et stylisé : la même interface couvre à la fois les scènes réalistes et les sorties artistiques stylisées, répondant à divers besoins, du visuel produit à l'illustration créative.

Scénarios d'application

Création de visuels pour réseaux sociaux par les équipes marketing — générer des visuels en portrait ou en carré à l'aide d'invites en chinois ou en anglais et d'un format spécifié, directement utilisables pour la diffusion de contenus sur les plateformes sociales.
Génération d'images de fond d'affiche et de textes de titre par les designers — saisir une invite contenant le texte du titre pour obtenir une image avec mise en page typographique, à utiliser comme ébauche d'affiche avant retouche.
Intégration de la génération d'images à partir de texte par les développeurs — transmettre l'invite et le ratio largeur-hauteur via l'interface unifiée pour intégrer les images générées à leurs propres applications ou processus de production de contenu.
Exploration de styles par les équipes créatives — faire varier les descriptions de style avec une même invite pour générer rapidement des images, afin de comparer les propositions et de confirmer les orientations visuelles.

Limites et conseils de sélection

L'interface ne prend actuellement en charge que deux entrées : l'invite textuelle et le ratio largeur-hauteur. Elle ne permet pas de retoucher une image ni de s'appuyer sur plusieurs images de référence, et ne propose pas de paramètres fins tels que le nombre d'étapes ou l'intensité de style. Pour les tâches nécessitant un contrôle précis de la composition, l'édition par calques ou la reproduction cohérente de personnages, il convient de se tourner vers des modèles prenant en charge ces capacités. Les résultats générés dépendent fortement de la formulation de l'invite ; il est recommandé de valider l'effet avec un petit nombre d'images avant de lancer des appels par lots.

Questions fréquentes

Voir toutes les questions →

À quoi sert Z-Image ?

Il est adapté à la génération d'images à faible coût à partir d'invites en chinois, aux portraits réalistes, aux enseignes, aux paysages urbains nocturnes et aux visuels culinaires.
Quels formats d'image sont pris en charge ?

Prise en charge de 1:1, 4:3, 3:4, 16:9 et 9:16.
Peut-on contrôler la résolution ou le format ?

Le contrat de requête public actuel n'expose que Prompt et aspect_ratio ; il ne faut pas ajouter de champs de résolution ou de format non déclarés dans la requête.
Prenez-vous en charge les images de référence ?

Non. L'ID actuel du modèle Z-Image correspond à une génération d'images purement textuelle.

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 : z-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequismaxLength 1000

Prompt textuel pour la génération d'images, contrôlant le contenu de l'image produite, prend en charge le chinois et l'anglais.

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur-hauteur de l'image de sortie, par défaut 1:1.

Options：1:14:33:416:99:16

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": "z-image",
  "input": {
    "prompt": "…",
    "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: "z-image",
    input: {
      "prompt": "…",
      "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": "z-image",
        "input": {
          "prompt": "…",
          "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"
    }
  }
}