---
title: "Usa Grok Imagine in Hermes Agent tramite RunAPI — Guida API Immagini e Video"
url: "https://runapi.ai/it/hermes-grok-imagine.md"
canonical: "https://runapi.ai/it/hermes-grok-imagine"
locale: "it"
model: "grok-imagine"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Posso usare Grok Imagine in 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.

### Ho bisogno di una API key separata per Grok Imagine?

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.

### Grok Imagine è asincrono o sincrono?

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.

### Quanto costa Grok Imagine?

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.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Grok Imagine →](https://runapi.ai/it/models/grok-imagine)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)