Usa Grok Imagine in Hermes Agent.
Grok Imagine è la suite di generazione di immagini e video di xAI — text-to-image, image-to-image, text-to-video e image-to-video. Hermes Agent lo chiama attraverso lo stesso provider RunAPI personalizzato e API key usati per la chat, senza plugin aggiuntivi da installare.
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"
}
Usa Grok Imagine in Hermes Agent in tre passaggi
Configura RunAPI
Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se il provider custom:runapi è già configurato in Hermes Agent per la chat, la stessa key funziona per Grok Imagine — nessuna configurazione aggiuntiva necessaria.
export RUNAPI_API_KEY=runapi_xxx
Chiama Grok Imagine
Invia una richiesta POST all'endpoint text_to_image con model impostato su grok-imagine-text-to-image. Includi il tuo prompt che descrive l'immagine. Per il video, usa text_to_video con grok-imagine-text-to-video.
text_to_image
Ottieni il risultato
L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine o video di output dalla risposta.
task_id: tsk_abc123
Parametri API Grok Imagine
| Parametro | Tipo | Descrizione |
|---|---|---|
model |
string |
Obbligatorio. Es. grok-imagine-text-to-image, grok-imagine-image-to-video. |
prompt |
string |
Descrizione testuale dell'output desiderato. |
image_url |
string |
URL dell'immagine sorgente per image-to-image o image-to-video. |
aspect_ratio |
string |
Facoltativo. Rapporto d'aspetto dell'output, es. 16:9, 1:1. |
Cos'è Grok Imagine su Hermes Agent?
Grok Imagine (Aurora) è il generatore di immagini e video di xAI che copre testo a immagine, modifica delle immagini e testo a video con sincronizzazione audio. Hermes Agent lo chiama tramite il provider custom:runapi, rendendo facile concatenare le uscite di Grok Imagine con altri modelli RunAPI in workflow multi-step -- ad esempio, generare una foto prodotto e poi passarla a un modello video per contenuto animato.
Casi d'uso di Grok Imagine
Foto prodotto generate dall'IA
Creare fotografia di prodotti da descrizioni testuali per listini e-commerce, cataloghi o campagne pubblicitarie senza servizio fotografico fisico.
Clip video con audio sincronizzato
Generare brevi clip video con audio abbinato da prompt testuali per reel social, teaser di prodotti o content marketing.
Generazione di personaggi per progetti creativi
Produrre design di personaggi coerenti in stili fotorealistici o anime per giochi, storie o progetti di branding usando prompt testuali dettagliati.
Domande su Grok Imagine + Hermes Agent
Sì. Se RunAPI è già configurato come provider custom:runapi in Hermes Agent, la stessa API key e base_url funzionano per Grok Imagine. Imposta il model su grok-imagine-text-to-image e chiama l'endpoint text_to_image.
No. La stessa RUNAPI_API_KEY che usi per la chat e altri modelli funziona anche per Grok Imagine. Una sola key copre tutti i 113+ modelli nel catalogo RunAPI.
Asincrono. L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché il task non si completa. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.
Grok Imagine usa la fatturazione per task tramite RunAPI. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Le generazioni fallite non vengono addebitate.
Configurazione generale di Hermes Agent
Non ancora configurato? Inizia con la guida di configurazione RunAPI per Hermes Agent.
Guida di configurazione di Hermes Agent →Catalogo modelli Grok Imagine
Vedi tutte le varianti, i prezzi e la documentazione API di Grok Imagine.
Modelli Grok Imagine →Prova Grok Imagine in Hermes Agent oggi.
Ottieni una API key RunAPI gratuita, configura il provider custom:runapi e inizia a generare immagini e video con xAI Grok Imagine.