Utiliser Z Image dans Hermes Agent.
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. Hermes Agent l'appelle via l'endpoint de fournisseur personnalisé RunAPI — même base_url et même clé API que celles utilisées pour le chat, aucun plugin supplémentaire ni location GPU requise.
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.
- Use the custom:runapi provider configured in your Hermes Agent config.yaml.
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 Hermes Agent en trois étapes
Configurer RunAPI
Définissez votre clé API RunAPI comme variable d'environnement. Si vous avez déjà configuré RunAPI comme fournisseur personnalisé dans Hermes Agent, la même clé et la même base_url fonctionnent 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 Hermes Agent ?
Z Image délivre ce que les utilisateurs décrivent comme une "vitesse et un réalisme fous" -- il génère des images photoréalistes en moins d'une seconde avec une forte adhérence aux prompts et des détails faciaux précis. Construit sur des poids open source Apache 2.0, c'est à la fois le modèle d'image le plus rapide et le moins cher sur RunAPI à environ 0,004 $ par image. Hermes Agent l'appelle via le même fournisseur personnalisé utilisé pour le chat.
Cas d'utilisation de Z Image
Storyboarding pour le cinéma et l'animation
Générer des images de storyboard à vitesse sous-seconde, itérant sur les compositions et les angles de caméra assez vite pour suivre les discussions créatives en temps réel.
Visualisation de produits e-commerce
Générer des images de listing produit avec des matériaux et un éclairage réalistes au coût par image le plus bas sur RunAPI, adapté à la génération de catalogues en grand volume.
Illustrations éducatives
Créer des diagrammes et illustrations éducatifs avec des étiquettes de texte bilingues, utiles pour des manuels, des matériaux de cours et du contenu de formation ciblant les publics chinois et anglais.
Questions sur Z Image + Hermes Agent
Oui. Si vous avez RunAPI configuré comme fournisseur personnalisé dans Hermes Agent, la même clé API et la même base_url 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 Hermes Agent
Pas encore configuré ? Commencez par le guide de configuration RunAPI pour Hermes Agent.
Guide de configuration Hermes Agent →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 Hermes Agent dès aujourd'hui.
Obtenez une clé RunAPI gratuite, configurez le fournisseur personnalisé et commencez à générer des images avec rendu de texte bilingue.