> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API ByteDance Seedance su Krea

> Usa ByteDance Seedance 2.5 e 2.0 tramite la Krea API. Genera video da testo o immagini con esempi REST e JavaScript, chiavi API e link ai prezzi.

Krea offre accesso API ai modelli di generazione video Seedance di ByteDance. Usa l'API Seedance su Krea per generare video da testo, animare immagini o guidare la generazione con riferimenti di immagini, video e audio. Le richieste usano un token API di Krea e l'URL di base `https://api.krea.ai`.

## Modelli API Seedance disponibili

| Modello | Endpoint POST | Durata del video | Risoluzione di output |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30 secondi | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15 secondi | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15 secondi | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15 secondi | 480p, 720p |

Questi modelli supportano text-to-video, frame iniziali e finali, media di riferimento e audio nativo. Consulta l'[API reference](https://www.krea.ai/docs/api-reference/introduction.md) per lo schema di richiesta attuale di ciascun modello. Controlla i [prezzi API ↗](https://www.krea.ai/app/api/pricing) prima di inviare un job: il prezzo dipende dal modello e dalle impostazioni di generazione.

> [!NOTE]
>
> Gli endpoint Seedance 2.0 e 2.0 Fast di Krea includono il miglioramento facoltativo del prompt e l'upscaling di Krea, oltre al modello base. Seedance 2.5 include il miglioramento facoltativo del prompt di Krea. Per le richieste di editing video con Seedance 2.5 che usano `reference_videos`, la durata e il rapporto d'aspetto dell'output derivano dal video sorgente; in queste richieste `duration` e `aspect_ratio` vengono ignorati.

## Ottenere una chiave API Seedance

Crea un token API di Krea e aggiungi saldo API seguendo [Chiavi API e fatturazione](https://www.krea.ai/docs/it/developers/api-keys-and-billing.md). Salva il token nella variabile d'ambiente `KREA_API_KEY` sul tuo server. Invialo come `Authorization: Bearer $KREA_API_KEY` e non esporlo mai nel codice eseguito nel browser.

Le unità di calcolo dell'app Krea e il saldo API sono separati. Le richieste Seedance tramite la Krea API usano il saldo API del tuo workspace.

## Generare un video

Invia un prompt all'endpoint Seedance 2.5 per la generazione text-to-video. Questi esempi richiedono un video orizzontale di cinque secondi a 720p.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

Installa l'SDK JavaScript con `npm install @krea-ai/sdk`. La richiesta REST restituisce un `job_id`, non il video finito. Esegui il polling di `GET /jobs/{job_id}` ogni 2–5 secondi finché `status` non è `completed`, quindi leggi l'URL del video da `result.urls[0]`. Interrompi il polling in caso di `failed` o `cancelled`. Il metodo `jobs.wait` dell'SDK gestisce il polling al posto tuo.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

Per le integrazioni in produzione, usa i [webhook](https://www.krea.ai/docs/it/developers/webhooks.md) per ricevere gli eventi di completamento. Consulta [ciclo di vita del job](https://www.krea.ai/docs/it/developers/job-lifecycle.md) e [errori e debugging](https://www.krea.ai/docs/it/developers/errors-and-debugging.md) per gli stati dei job e la gestione degli errori.

## Animare un'immagine

Per la generazione image-to-video con Seedance, usa lo stesso endpoint e aggiungi `start_image` alla richiesta. Passa l'URL di un'immagine raggiungibile pubblicamente, l'URL di un asset caricato o un data URI base64.

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

Sostituisci `start_image` con l'URL della tua immagine. Per controllare il frame finale, aggiungi `end_image`. Per la generazione guidata da riferimenti, usa `reference_images`, `reference_videos` e `reference_audios` secondo lo [schema API](https://www.krea.ai/docs/api-reference/introduction.md) del modello selezionato.

## Domande frequenti

### Krea offre un'API ByteDance Seedance?

Sì. Krea offre ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini tramite la sua API REST all'indirizzo `https://api.krea.ai`. Autenticati con un token API di Krea e invia una richiesta a uno degli endpoint Seedance elencati sopra.

### Posso usare Seedance sia per text-to-video sia per image-to-video?

Sì. Invia un `prompt` per il text-to-video oppure aggiungi `start_image` per animare un'immagine. Entrambi i flussi di lavoro usano lo stesso endpoint del modello Seedance e restituiscono un job asincrono.

### Mi serve una chiave API ByteDance separata?

No. Le chiamate a Seedance tramite Krea usano il tuo token API di Krea e il saldo API del workspace. Non è necessario inviare credenziali ByteDance separate con queste richieste.

### Quanto costa l'API Seedance su Krea?

Consulta i [prezzi della Krea API ↗](https://www.krea.ai/app/api/pricing) per i prezzi attuali di Seedance e le impostazioni disponibili. L'utilizzo dell'API viene fatturato separatamente dalle unità di calcolo dell'app Krea. I job falliti e annullati non vengono addebitati.

### Posso chiamare Seedance da un agente AI?

Sì. Collega un agente al [server MCP di Krea](https://www.krea.ai/docs/it/developers/mcp.md) per scoprire i modelli video disponibili e i relativi schemi. Puoi anche chiamare l'API REST o l'SDK JavaScript direttamente dalla tua applicazione.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.