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

# Usa Seedance in Hermes Agent.

Seedance 2.0 genera video da 4 a 15 secondi fino a 1080p con fatturazione al secondo a partire da circa $0.05/sec — il costo al secondo più basso tra i modelli video RunAPI. Supporta input multimodali di riferimento (URL di immagini, video e audio), controllo del primo/ultimo fotogramma e sincronizzazione audio nativa. Hermes Agent lo chiama tramite l'endpoint personalizzato RunAPI — configura custom:runapi una volta e riutilizza la stessa key.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/seedance/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A ceramic coffee mug rotates slowly on a wooden table, steam rising, warm morning light from a window, cinematic",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedance-2.0"
}

```

## How it works

1. **Configura RunAPI** — Imposta RUNAPI_API_KEY nell'ambiente in cui Hermes Agent è in esecuzione. Se hai già aggiunto RunAPI come provider custom:runapi per la chat, la stessa key e base_url gestiscono la generazione video. In caso contrario, aggiungi il provider personalizzato con base_url https://runapi.ai/v1 ed esegui hermes doctor.
2. **Chiama Seedance text_to_video** — Invia una richiesta POST all'endpoint text_to_video con model impostato su seedance-2.0. Includi un prompt, duration_seconds (4–15), aspect_ratio e output_resolution. Facoltativamente allega first_frame_image_url, reference_image_urls o reference_audio_urls per il controllo multimodale. Hermes Agent invia la richiesta tramite il provider custom:runapi.
3. **Ottieni il risultato** — L'endpoint restituisce subito un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non è completed, poi leggi l'URL del video di output dalla risposta. La fatturazione è al secondo in base alla durata del video generato e alla risoluzione.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. seedance-2.0, seedance-2.0-fast, seedance-1.5-pro, seedance-v1-pro, seedance-v1-lite. |
| `prompt` | `string` | Obbligatorio. Descrizione testuale della scena video da generare. |
| `duration_seconds` | `integer` | Durata del video in secondi. 4–15 per Seedance 2.0, 5 o 10 per le varianti v1. |
| `aspect_ratio` | `string` | Rapporto d'aspetto dell'output. Valori accettati: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto. |
| `output_resolution` | `string` | Risoluzione video. Valori accettati: 480p, 720p, 1080p. Risoluzioni più alte costano di più per secondo. |
| `first_frame_image_url` | `string` | Facoltativo. URL di un'immagine da usare come primo fotogramma. Abilita flussi di lavoro image-to-video. |
| `last_frame_image_url` | `string` | Facoltativo. URL di un'immagine da usare come ultimo fotogramma. Vincola la scena finale. |
| `reference_image_urls` | `array` | Facoltativo. URL di immagini di riferimento per la guida di posa, profondità o bordi. |
| `reference_audio_urls` | `array` | Facoltativo. URL di file audio di riferimento per la sincronizzazione audio nativa nel video generato. |
| `reference_video_urls` | `array` | Facoltativo. URL di video di riferimento per il trasferimento di movimento o stile. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task è completato. |

## FAQ

### Posso usare Seedance in Hermes Agent?

Sì. Configura RunAPI come provider personalizzato in Hermes Agent con base_url https://runapi.ai/v1, poi chiama l'endpoint text_to_video con model impostato su seedance-2.0. La stessa API key gestisce sia la chat che la generazione video.

### Come funziona la fatturazione al secondo di Seedance?

La fatturazione è basata sulla durata effettiva del video generato e sulla risoluzione di output selezionata. Un video a 480p costa meno per secondo rispetto a 1080p. Il costo viene addebitato dopo che il video è completato, non quando il task viene creato.

### Hermes Agent ha bisogno di un plugin per la generazione video?

No. Hermes Agent invia richieste HTTP tramite il provider custom:runapi nello stesso modo in cui invia richieste di chat. L'endpoint text_to_video accetta un corpo JSON e restituisce un task ID. Non sono richiesti plugin o estensioni aggiuntivi.

### Seedance può generare video a partire da un'immagine?

Sì. Passa un URL immagine nel parametro first_frame_image_url insieme a un prompt testuale. Seedance usa l'immagine come fotogramma iniziale e genera il movimento a partire da essa. Puoi anche impostare last_frame_image_url per vincolarne la fine.

### Quanto può essere lungo un video Seedance 2.0?

Seedance 2.0 genera video da 4 a 15 secondi. Imposta il parametro duration_seconds sulla durata desiderata. Le varianti precedenti (v1-pro, v1-lite) supportano solo durate fisse di 5 o 10 secondi. Per contenuti più lunghi, concatena più clip usando prompt coerenti per i personaggi e ancoraggi al primo/ultimo fotogramma.


## Links

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