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

# Usa Wan in Hermes Agent.

Wan è il modello open-source di generazione video e immagini di Alibaba, con licenza Apache 2.0 e al primo posto nella classifica Artificial Analysis text-to-video. Copre 20+ varianti da Wan 2.2 a 2.7 — text-to-video, image-to-video, speech-to-video con lip-sync, editing video tramite R2V e generazione di immagini fino a 4K. Hermes Agent chiama qualsiasi endpoint Wan tramite lo stesso provider personalizzato RunAPI e la stessa API key usata per la chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/task/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.7-text-to-video",
    "prompt": "A drone shot rising over terraced rice paddies at golden hour, mist rolling through the valleys, slow upward camera tilt",
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "wan-2.7-text-to-video"
}

```

## How it works

1. **Configura RunAPI** — Imposta RUNAPI_API_KEY nell'ambiente in cui gira Hermes Agent. Se hai già aggiunto RunAPI come provider custom:runapi, la stessa key e base_url gestiscono tutti gli endpoint Wan — nessuna configurazione aggiuntiva necessaria.
2. **Chiama un endpoint Wan** — Invia una richiesta POST a text_to_video con model impostato su wan-2.7-text-to-video e output_resolution a 720p o 1080p. Per image-to-video, usa wan-2.7-image-to-video con un first_frame_image_url. Per video guidato dal parlato, usa wan-2.2-a14b-speech-to-video-turbo con source_audio_url e source_image_url. Hermes Agent instrada tutte le richieste tramite il provider custom:runapi.
3. **Ottieni il risultato** — L'endpoint restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non è completed, poi leggi l'URL del video o dell'immagine di output dalla risposta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. wan-2.7-text-to-video, wan-2.6-text-to-video, wan-2.5-text-to-video, wan-2.2-a14b-text-to-video-turbo, o wan-2.7-r2v. |
| `prompt` | `string` | Obbligatorio. Descrizione testuale della scena video desiderata, incluso movimento della telecamera, illuminazione e dettagli del soggetto. |
| `output_resolution` | `string` | Facoltativo. 720p o 1080p per Wan 2.5+. Wan 2.2 accetta anche 480p e 580p. Predefinito a 720p. |
| `aspect_ratio` | `string` | Facoltativo. Solo per wan-2.7-r2v. Valori accettati: 16:9, 9:16, 1:1, 4:3, 3:4. |
| `duration_seconds` | `integer` | Facoltativo. Solo per wan-2.7-r2v. Durata del video in secondi, da 2 a 10. |
| `seed` | `integer` | Facoltativo. Seed di riproducibilità per output deterministico. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task si completa. |

## FAQ

### Quali endpoint Wan posso chiamare da Hermes Agent?

Tutti. text_to_video, image_to_video, speech_to_video, text_to_image (Wan 2.7 Image), edit_video e animate. Configura RunAPI come provider custom:runapi una volta sola, poi cambia endpoint e slug di modello per ogni richiesta — ad esempio wan-2.7-text-to-video per video e wan-2.7-image per la generazione di immagini fino a 4K.

### Come configuro RunAPI come provider personalizzato in Hermes Agent per Wan?

Aggiungi una voce di provider custom:runapi con base_url impostato su https://runapi.ai/v1 e la tua RUNAPI_API_KEY come API key. Una volta configurato, ogni endpoint Wan — e tutti i 113+ modelli RunAPI — è accessibile tramite lo stesso provider senza plugin aggiuntivi.

### Qual è la differenza tra Wan 2.5, 2.6 e 2.7?

Wan 2.5 ha introdotto l'output a 1080p. Wan 2.6 ha aggiunto l'editing video (R2V) e varianti flash per una generazione più veloce. Wan 2.7 aggiunge la generazione di immagini (wan-2.7-image, wan-2.7-image-pro fino a 4K), l'editing video (wan-2.7-edit-video) e una qualità text-to-video migliorata che guida la classifica di Artificial Analysis.

### Come funziona lo speech-to-video con Wan?

Usa wan-2.2-a14b-speech-to-video-turbo con source_audio_url (il file audio) e source_image_url (il volto da animare). Wan genera un video con lip-sync in cui il volto pronuncia l'audio. La risoluzione di output supporta 480p, 580p o 720p.

### Wan è open-source? Posso self-hostarlo?

Sì. Wan è rilasciato con licenza Apache 2.0 da Alibaba e i pesi del modello sono pubblicamente disponibili. Tramite RunAPI salti la configurazione GPU — una sola chiamata API genera video o immagini. Se hai bisogno di una pipeline self-hosted per la privacy, gli stessi pesi girano sulla tua infrastruttura.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Wan su RunAPI →](https://runapi.ai/it/models/wan)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)