Utiliser Grok Imagine dans Hermes Agent.
Grok Imagine est la suite de génération d'images et de vidéos de xAI — texte-vers-image, image-vers-image, texte-vers-vidéo et image-vers-vidéo. Hermes Agent l'appelle via le même fournisseur personnalisé RunAPI et la même clé API utilisés pour le chat, sans plugins supplémentaires à installer.
Use RunAPI to generate an image with xAI Grok Imagine.
Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Use the custom:runapi provider already configured in Hermes Agent.
- Set the model to "grok-imagine-text-to-image".
- Write a descriptive prompt for the image you want.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-text-to-image",
"prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "grok-imagine-text-to-image"
}
Utiliser Grok Imagine dans Hermes Agent en trois étapes
Configurer RunAPI
Définissez la variable d'environnement RUNAPI_API_KEY dans votre profil shell. Si le fournisseur custom:runapi est déjà configuré dans Hermes Agent pour le chat, la même clé fonctionne pour Grok Imagine — aucune configuration supplémentaire requise.
export RUNAPI_API_KEY=runapi_xxx
Appeler Grok Imagine
Envoyez une requête POST à l'endpoint text_to_image avec le modèle grok-imagine-text-to-image. Incluez votre prompt décrivant l'image. Pour la vidéo, utilisez text_to_video avec grok-imagine-text-to-video.
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 ou de la vidéo depuis la réponse.
task_id: tsk_abc123
Paramètres API de Grok Imagine
| Paramètre | Type | Description |
|---|---|---|
model |
string |
Requis. Ex. grok-imagine-text-to-image, grok-imagine-image-to-video. |
prompt |
string |
Description textuelle de la sortie souhaitée. |
image_url |
string |
URL de l'image source pour image-vers-image ou image-vers-vidéo. |
aspect_ratio |
string |
Optionnel. Ratio d'aspect de sortie, ex. 16:9, 1:1. |
Qu'est-ce que Grok Imagine sur Hermes Agent ?
Grok Imagine (Aurora) est le générateur d'images et de vidéos de xAI couvrant le texte-vers-image, l'édition d'images et le texte-vers-vidéo avec synchronisation audio. Hermes Agent l'appelle via le fournisseur custom:runapi, facilitant le chaînage des sorties de Grok Imagine avec d'autres modèles RunAPI dans des workflows multi-étapes -- par exemple, générer une photo produit puis la transmettre à un modèle vidéo pour du contenu animé.
Cas d'utilisation de Grok Imagine
Photos produit générées par IA
Créer de la photographie produit à partir de descriptions textuelles pour des listings e-commerce, des catalogues ou des campagnes publicitaires sans séance photo physique.
Clips vidéo avec audio synchronisé
Générer de courts clips vidéo avec audio assorti à partir de prompts textuels pour des reels sociaux, des teasers produit ou du marketing de contenu.
Génération de personnages pour projets créatifs
Produire des designs de personnages cohérents en styles photoréaliste ou anime pour des jeux, des histoires ou des projets de branding avec des prompts textuels détaillés.
Questions sur Grok Imagine + Hermes Agent
Oui. Si RunAPI est déjà configuré comme fournisseur personnalisé (custom:runapi) dans Hermes Agent, la même clé API et la même base_url fonctionnent pour Grok Imagine. Définissez le modèle sur grok-imagine-text-to-image et appelez l'endpoint text_to_image.
Non. La même RUNAPI_API_KEY que vous utilisez pour le chat et les autres modèles fonctionne également pour Grok Imagine. Une seule clé couvre plus de 113 modèles dans le catalogue RunAPI.
Asynchrone. L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche jusqu'à ce que la tâche se termine. Les SDK RunAPI et le CLI gèrent le polling automatiquement.
Grok Imagine utilise une facturation par tâche via RunAPI. Consultez la page des tarifs RunAPI pour les tarifs actuels. Les générations échouées ne sont pas facturées.
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 Grok Imagine
Voir toutes les variantes, les tarifs et la documentation API de Grok Imagine.
Modèles Grok Imagine →Essayez Grok Imagine dans Hermes Agent dès aujourd'hui.
Obtenez une clé RunAPI gratuite, configurez le fournisseur custom:runapi et commencez à générer des images et vidéos avec Grok Imagine de xAI.