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

# Usa Seedance in OpenClaw.

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. Gli agenti OpenClaw lo chiamano tramite la stessa API key e lo stesso endpoint RunAPI usati per la chat.

## 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 nel tuo ambiente. Se hai già configurato RunAPI per la chat in OpenClaw, la stessa key funziona per la generazione video Seedance — nessuna configurazione provider aggiuntiva necessaria.
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.
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 OpenClaw?

Sì. Configura RunAPI come provider compatibile con OpenAI in OpenClaw, 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.

### Qual è la differenza tra seedance-2.0 e seedance-2.0-fast?

Seedance 2.0 supporta output fino a 1080p e costa di più per secondo. Seedance 2.0-fast si limita a 720p ma genera più velocemente e costa meno. Entrambi accettano gli stessi input multimodali di riferimento.

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

### Come funzionano i reference_audio_urls con Seedance?

Seedance 2.0 può sincronizzare il movimento del video generato con una traccia audio. Passa l'URL del file audio in reference_audio_urls e il modello allinea il movimento visivo all'audio — utile per video musicali o scene con dialoghi senza una fase separata audio-to-video.


## Links

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