Usa Grok Imagine in OpenClaw.
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. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI e endpoint /v1 usati per la chat, senza skill aggiuntive 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.
- 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 OpenClaw in tre passaggi
Configura RunAPI
Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se RunAPI è già configurato in OpenClaw 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 OpenClaw?
Grok Imagine (Aurora) è il generatore di immagini e video di xAI integrato nella piattaforma Grok. Produce ritratti fotorealistici, illustrazioni in stile anime e brevi clip video con audio sincronizzato da prompt testuali. Gli agenti OpenClaw lo chiamano tramite RunAPI per la generazione da testo a immagine, la modifica delle immagini e la generazione video senza bisogno di un abbonamento Grok o SuperGrok.
Casi d'uso di Grok Imagine
Generazione di ritratti fotorealistici
Generare ritratti realistici di alta qualità e immagini di personaggi da descrizioni testuali, utili per profili sui social media, persona di marketing o progetti creativi.
Creazione di contenuto per i social media
Produrre immagini e brevi clip video per post social, stories e annunci direttamente da prompt testuali, senza filigrana sulle uscite.
Opere d'arte stilizzate e personaggi anime
Creare arte in stile illustrazione e personaggi anime da prompt dettagliati, generando design di personaggi coerenti per giochi, branding o serie di contenuti.
Domande su Grok Imagine + OpenClaw
Sì. Se RunAPI è già configurato come provider compatibile con OpenAI in OpenClaw, la stessa API key e l'endpoint /v1 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 OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli Grok Imagine
Vedi tutte le varianti, i prezzi e la documentazione API di Grok Imagine.
Modelli Grok Imagine →Prova Grok Imagine in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a generare immagini e video con xAI Grok Imagine.