Utiliser Z Image dans OpenClaw.
Z Image est le modèle de génération d'images rapide d'Alibaba avec rendu de texte bilingue en chinois et en anglais. Les agents OpenClaw l'appellent via le même endpoint RunAPI et la même clé API utilisés pour le chat — aucun skill supplémentaire ni compte de fournisseur requis.
Use the RunAPI text_to_image endpoint to generate an image with Z Image.
Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Send a POST request to https://runapi.ai/v1/text_to_image.
- Set model to "z-image".
- Write a descriptive prompt for the image you want to generate.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the image URL from the output.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "z-image"
}
Utiliser Z Image dans OpenClaw en trois étapes
Configurer RunAPI
Définissez votre clé API RunAPI comme variable d'environnement. Si vous avez déjà configuré RunAPI pour le chat dans OpenClaw, la même clé fonctionne pour la génération d'images.
export RUNAPI_API_KEY=runapi_xxx
Appeler Z Image
Envoyez une requête POST à l'endpoint text_to_image avec le modèle z-image et un prompt textuel. Z Image supporte les prompts en chinois et en anglais avec rendu de texte précis.
text_to_image
Obtenir le résultat
L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche jusqu'à ce que le statut passe à completed, puis récupérez l'URL de l'image générée depuis la sortie de la réponse.
task_id: tsk_abc123
Paramètres API de Z Image
| Paramètre | Type | Description |
|---|---|---|
model |
string |
Requis. Utilisez z-image. |
prompt |
string |
Description textuelle. Supporte le chinois et l'anglais. |
negative_prompt |
string |
Optionnel. Ce à éviter dans l'image. |
size |
string |
Optionnel. Dimensions de sortie, ex. 1024x1024. |
Qu'est-ce que Z Image sur OpenClaw ?
Z Image est le modèle d'image optimisé pour la vitesse que les utilisateurs qualifient d'"incroyable" pour sa génération en sous-seconde et sa sortie ultra-réaliste sur du matériel grand public. Il fonctionne en open source Apache 2.0, rend du texte bilingue en chinois et en anglais, et capture des détails faciaux subtils que d'autres modèles rapides manquent. À environ 0,004 $ par image via RunAPI, c'est l'une des options les moins chères disponibles. Les agents OpenClaw l'appellent avec la même clé API utilisée pour le chat.
Cas d'utilisation de Z Image
Exploration de concepts et prototypage rapide
Générer des dizaines de concepts visuels en secondes à des fractions de centime chacun, idéal pour explorer des directions avant de s'engager sur un modèle plus coûteux pour la sortie finale.
Campagnes marketing bilingues
Créer des visuels marketing avec du texte chinois et anglais correctement rendu dans une seule image, utile pour le e-commerce transfrontalier et les réseaux sociaux multilingues.
Maquettes de photographie mode et produit
Générer des maquettes de photographie produit réalistes avec des textures de matériaux et un éclairage précis, assez rapide pour itérer sur les compositions en temps réel.
Questions sur Z Image + OpenClaw
Oui. Si vous avez RunAPI configuré comme fournisseur dans OpenClaw, la même clé API et le même endpoint gèrent les requêtes Z Image. Envoyez un POST à l'endpoint text_to_image avec le modèle z-image.
Non. La même RUNAPI_API_KEY que vous utilisez pour le chat et les autres modèles fonctionne également pour Z Image. Tous les modèles RunAPI partagent une seule clé et un seul solde de crédits.
Z Image est asynchrone. L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche ou utilisez un webhook de rappel pour savoir quand l'image est prête. Les SDK RunAPI gèrent le polling automatiquement.
Z Image utilise une tarification à l'usage avec facturation par tâche. Consultez la page des tarifs RunAPI pour le tarif actuel. Il n'y a pas d'abonnement mensuel ni de dépense minimum.
Configuration générale de OpenClaw
Pas encore configuré ? Commencez par le guide de configuration RunAPI pour OpenClaw.
Guide de configuration OpenClaw →Catalogue des modèles Z Image
Voir toutes les variantes, les tarifs et la documentation API de Z Image.
Modèles Z Image →Essayez Z Image dans OpenClaw dès aujourd'hui.
Obtenez une clé RunAPI gratuite, collez le prompt dans OpenClaw et commencez à générer des images avec rendu de texte bilingue.