<!-- Canonical URL: https://ask.atlascloud.ai/it/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Seedance 2.5 API Guida rapida: Genera il tuo primo video con Atlas Cloud

> Rilascia oggi un'integrazione funzionante con Seedance video su Atlas Cloud con una chiave API e due chiamate REST, poi sostituisci con Seedance 2.5 al lancio cambiando una stringa modello.

Hai letto l'annuncio di [Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud), hai abbozzato una funzionalità del prodotto basata su clip generate di 30 secondi e ora vuoi scrivere codice. Poi ti scontri con il muro che ogni sviluppatore incontra con un modello appena annunciato: la pagina delle capacità è attiva, ma l'endpoint che puoi effettivamente chiamare dalla tua app è un'altra questione.

Ecco la versione onesta della situazione e una guida rapida che la rispetta. Atlas Cloud ha pubblicato una [pagina della famiglia Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5 che si impegna all'accesso dal Day-0 sugli stessi endpoint unificati che già servono [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) e 1.5. Al momento della scrittura, quell'elenco è contrassegnato "Coming Soon" e nessun prezzo Atlas Cloud per Seedance 2.5 è stato pubblicato. Ciò significa in pratica una buona notizia: l'integrazione che costruisci oggi contro un livello Seedance attivo è la stessa integrazione che eseguirai al lancio di 2.5. L'unica cosa che cambia è la stringa del modello.

Quindi questa guida rapida svolge due compiti. Ottiene un video reale da un endpoint reale oggi e struttura il tuo codice e i tuoi prompt in modo che l'aggiornamento sia una differenza di una riga.

## Cosa sta effettivamente arrivando in Seedance 2.5

Secondo la pagina ufficiale di Seedance 2.5 di ByteDance, si tratta di un modello di generazione congiunta audio-video di nuova generazione costruito per narrazioni di 30 secondi con controllo preciso dei riferimenti e potenti funzionalità di editing. Le affermazioni concrete per cui vale la pena progettare:

* Fino a 30 secondi in una singola generazione, con la possibilità di estendere due volte per narrazioni più lunghe e complete
* Movimenti più fluidi e coerenti, con immagini più realistiche
* Comprensione più precisa del video di riferimento, catturando l'intenzione, l'inquadratura e il linguaggio cinematografico anziché limitarsi a trasferire il movimento
* Editing più affidabile su una gamma più ampia di richieste di modifica audio e visive
* Controllo del modello white e editing a schermo verde, oltre a movimenti professionali della telecamera e blocking delle performance, pensati per flussi di lavoro di produzione complessi

Nota cosa non è in quell'elenco: nessuna tabella di benchmark, nessuna scala di risoluzione, nessun conteggio di asset di riferimento. Tutto ciò che hai visto in tal senso è una vernice di marketing di qualcuno, non la scheda tecnica ufficiale. Costruisci sulle affermazioni di cui sopra.

## Passo 1: ottenere una chiave dalla console

Accedi a console.atlascloud.ai e crea una chiave API. Non c'è deposito, nessun impegno minimo e nessuna lista d'attesa, quindi la chiave è utilizzabile immediatamente su base pay-as-you-go. Una chiave copre l'intero catalogo di oltre 300 modelli tra testo, immagini e video, su un unico account di fatturazione, che è la parte che conta per questa guida rapida: la chiave che crei ora è la stessa chiave che chiamerà Seedance 2.5.

Salvala come variabile d'ambiente, mai nel codice sorgente. `ATLASCLOUD_API_KEY` è un nome adatto.

## Passo 2: inviare un job video

La generazione video su Atlas Cloud è una chiamata REST asincrona in due passaggi, non una chat completion. Fai una POST a un job e ottieni un ID di previsione, poi interroghi quell'ID fino a quando il rendering non termina. Qualsiasi client HTTP funziona, quindi non c'è SDK del fornitore da installare e nessun nuovo schema di autenticazione da imparare: è un bearer token sulla chiave che hai appena creato.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

La risposta arriva come `{"code": 200, "data": {"id": "...", "status": "processing"}}`. Nota che `model` è un semplice campo stringa. Questo dettaglio è l'intera storia dell'aggiornamento per questo articolo, e il Passo 6 ci tornerà.

## Passo 3: interrogare fino al completamento del rendering

Un clip di 5 secondi non è una risposta istantanea, quindi tratta il rendering come un job con un ciclo di vita piuttosto che una chiamata bloccante. Interroga l'endpoint di previsione finché `status` non raggiunge un valore terminale.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # in caso di successo, il payload contiene gli URL di output
```

Due cose che vale la pena implementare ora piuttosto che dopo. Metti un limite al ciclo di polling in modo che un job bloccato non possa bloccare un gestore di richieste, e salva l'ID di previsione prima di iniziare il polling in modo che un worker crashato possa riprendere invece di pagare due volte per il rendering. Entrambe le abitudini rimangono invariate per 2.5.

Se la tua funzionalità funziona da un'immagine di riferimento o un riferimento al soggetto invece del testo puro, lo stesso flusso si applica con una variante di modello diversa, `bytedance/seedance-2.0/image-to-video` o `bytedance/seedance-2.0/reference-to-video`. Gli asset di riferimento del soggetto vengono caricati una volta tramite `uploadMedia` e poi passati come `asset://<id>` nei campi immagine, quindi un personaggio ricorrente o un prodotto non necessita di un nuovo caricamento ad ogni chiamata.

## Passo 4: scegliere un livello Seedance attivo e sapere quanto costa un secondo

Atlas Cloud fattura il video al secondo di durata dell'output. È un'aritmetica che puoi fare a mente prima di scrivere qualsiasi codice. Tre livelli Seedance sono attivi oggi:

| Modello | ID modello | Prezzo Atlas Cloud | Note |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/s | Livello principale attivo, chiave immediata, nessuna lista d'attesa |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/s | Variante più veloce della stessa famiglia |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/s | Livello Seedance 2.0 attivo più economico, anche image-to-video e reference-to-video |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/s, o $0.018/s sulla variante Fast | Audio sincronizzato nativo, lip sync multilingue, clip da 4 a 12 secondi |

Per orientamento, altri modelli video sulla stessa chiave rientrano in una fascia comparabile: Grok Imagine Video v1.5 a $0.080/s, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) a $0.100/s, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo a $0.112 standard e $0.095 scontato, MiniMax H3 a $0.14/s.

Su quale costruire dipende da cosa farà alla fine la tua funzionalità 2.5. Se l'audio è centrale per l'output, Seedance 1.5 Pro è il livello che ha già audio sincronizzato nativo e lip sync multilingue, quindi la tua pipeline impara a gestire una traccia audio dal primo giorno. Se stai iterando sulla struttura del prompt e vuoi il costo più basso per esperimento, Seedance 2.0 Mini a $0.056/s è la sandbox ovvia. Se vuoi il rendering più vicino a una generazione di produzione di livello attuale, Seedance 2.0 a $0.112/s è la scelta diretta, con la variante Fast a $0.09/s se la velocità effettiva conta più dell'ultimo incremento di qualità.

## Passo 5: controllare il prezzo live nel Playground prima di spendere

Prima della tua prima chiamata a pagamento, apri il modello nel Playground di Atlas Cloud. Ogni modello mostra il suo prezzo live per modello accanto al pulsante Run. Questo è più importante di quanto sembri: sconti promozionali vanno e vengono, e il numero accanto al pulsante Run è quello che effettivamente verrà fatturato. Esegui una generazione nel Playground, conferma che l'output sia ciò di cui la tua funzionalità ha bisogno, poi trasferisci le impostazioni nel codice.

Il modello di fatturazione per secondo di output rende anche la tua conversazione sul budget banale. Un clip di 10 secondi su Seedance 2.0 Mini costa 10 × $0.056. Non c'è calcolatrice, nessuna stima di token e nessun passaggio di riconciliazione post-hoc.

Vale la pena confrontarlo con come i canali first-party di ByteDance fatturano Seedance. Su Volcano Engine Ark in Cina e BytePlus ModelArk a livello internazionale, la fatturazione è basata sui token: il consumo stimato di token è (durata video in input + durata video in output) × larghezza output × altezza output × frame rate output / 1024, moltiplicato per un prezzo unitario del token, con l'utilizzo effettivo autorevole dal campo `usage.completion_tokens` nella risposta API. Per la serie Seedance 2.0 e Seedance 2.5, quando l'input include video, si applica un minimo di consumo di token, e il minimo dipende da risoluzione, aspect ratio e durata dell'output. ByteDance pubblica un calcolatore di prezzi più una tabella dei token minimi proprio per questo motivo.

Entrambi i modelli sono legittimi. Ma se stai facendo un budget per un rendering di 30 secondi, il costo per secondo di durata dell'output è aritmetica mentale e i token con minimi richiedono un foglio di calcolo.

## Passo 6: scrivere la descrizione dell'inquadratura come se fosse già 2.5

Questa è la parte della guida rapida che si trasferisce perfettamente, perché l'arte del prompt non ha versioni. Due delle affermazioni sulle capacità di 2.5 dovrebbero cambiare il modo in cui scrivi oggi.

**Controllo preciso del riferimento.** L'affermazione di ByteDance è che 2.5 legge un video di riferimento per la sua intenzione, inquadratura e linguaggio cinematografico, andando oltre il trasferimento di movimento. L'implicazione per il prompt è che il tuo asset di riferimento smette di essere un modello di movimento e inizia a essere un briefing da regista. Quindi smetti di scrivere prompt che descrivono solo il soggetto e inizia a nominare la grammatica che vuoi venga trasferita: la sensazione dell'obiettivo, l'inquadratura, il ritmo del taglio, se la telecamera guida o segue il soggetto. Scrivi "handheld, subject-following medium shot, slight lag on turns" invece di "person walking, cinematic".

**Trenta secondi in una singola generazione.** Un clip di 5 secondi è una singola inquadratura. Trenta secondi è una scena con struttura, e 2.5 supporta l'estensione due volte in aggiunta. Quindi scrivi descrizioni di inquadratura con una struttura di battute piuttosto che una singola descrizione statica: una battuta di ambientazione, un cambiamento (una svolta, un'entrata, una rivelazione) e una risoluzione. Nomina esplicitamente il movimento della telecamera e il blocking delle performance, poiché sono esattamente i controlli a cui mira 2.5. Dove sta il soggetto, dove si muove, cosa fa la telecamera mentre si muove.

Entrambe le abitudini ripagano sui livelli attivi ora. Entrambe sono le esatte abitudini che 2.5 premia.

## Passo 7: pianificare lo scambio

Struttura il tuo codice in modo che l'identificatore del modello sia una configurazione, non un letterale. Una costante, letta dall'ambiente o dalla configurazione:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Poi passa `SEEDANCE_MODEL` dove il Passo 2 ha hardcodato la stringa. Poiché `model` è un singolo campo stringa JSON nel corpo di `generateVideo`, l'aggiornamento al lancio di 2.5 è davvero una variabile d'ambiente. Non una metafora per un piccolo cambiamento, letteralmente un valore.

Non hardcodare mai un identificatore Seedance 2.5 oggi, perché non esiste ancora un ID modello Seedance 2.5 di Atlas Cloud. Prendi gli ID live esatti dal catalogo su atlascloud.ai/models piuttosto che copiarli da un articolo, incluso questo, poiché nel tempo vengono aggiunte nuove varianti. Quando 2.5 arriverà con l'impegno del Day-0, il lavoro da parte tua è quella singola variabile, più un nuovo sguardo al prezzo accanto al pulsante Run e una rilettura di eventuali nuovi parametri di richiesta, poiché un modello da 30 secondi con supporto per l'estensione accetterà plausibilmente campi che il corpo di 2.0 non ha.

Nel frattempo, se hai bisogno di Seedance 2.5 oggi piuttosto che al lancio di Atlas Cloud, la risposta onesta sono i canali first-party di ByteDance: Volcano Engine Ark in Cina e BytePlus ModelArk a livello internazionale. Tra gli aggregatori, molti sono nello stesso stato di pre-lancio o impegno Day-0.

## FAQ

Q: Posso chiamare Seedance 2.5 su Atlas Cloud adesso?
R: No. La pagina della famiglia Seedance 2.5 su Atlas Cloud è contrassegnata "Coming Soon" con un impegno di accesso dal Day-0 sugli stessi endpoint unificati che già servono Seedance 2.0 e 1.5. Nessun ID modello e nessun prezzo sono stati ancora pubblicati.

Q: Quanto costa Seedance su Atlas Cloud oggi?
R: Seedance 2.0 è $0.112/s, Seedance 2.0 Fast è $0.09/s, Seedance 2.0 Mini è $0.056/s, e Seedance 1.5 Pro è $0.047/s o $0.018/s sulla sua variante Fast. La fatturazione è per secondo di durata dell'output e il prezzo live è mostrato accanto al pulsante Run nel Playground.

Q: Ho bisogno di un SDK speciale per il video su Atlas Cloud?
R: No. Il video è un flusso REST semplice: `POST /api/v1/model/generateVideo` per inviare un job, poi `GET /api/v1/model/prediction/{id}` per interrogarlo, entrambi autenticati con un bearer token sulla tua chiave Atlas Cloud. Qualsiasi client HTTP funziona. Nota che il video non passa attraverso l'endpoint chat compatibile con OpenAI che il catalogo testuale utilizza, quindi non aspettarti che `chat.completions` renderizzi un clip. I parametri di richiesta per modello sono documentati su atlascloud.ai/docs.

Q: C'è un deposito o un impegno minimo per iniziare?
R: No. Atlas Cloud è pay-as-you-go senza deposito, nessun impegno minimo e nessuna lista d'attesa, e la chiave da console.atlascloud.ai è utilizzabile immediatamente.

Q: Su quale livello live dovrei prototipare se sto puntando a 2.5?
R: Seedance 2.0 Mini a $0.056/s per iterazioni economiche sui prompt, Seedance 1.5 Pro se la tua pipeline deve gestire una traccia audio sincronizzata nativa, e Seedance 2.0 a $0.112/s per il rendering di produzione più vicino all'attuale generazione.

## Il punto cruciale

Atlas Cloud esegue Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini e Seedance 1.5 Pro oggi su una singola chiave API con fatturazione al secondo sulla durata dell'output, certificazione SOC II, conformità HIPAA e crittografia a riposo e in transito, e ha pubblicato un impegno Day-0 per servire Seedance 2.5 sugli stessi endpoint unificati quando sarà disponibile.

Per indicazioni di implementazione correlate, vedi [le ultime API per immagini, video e LLM disponibili ora](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) e [stima di capacità, latenza e costo dell'inferenza AI](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).