<!-- Canonical URL: https://ask.atlascloud.ai/it/migrate-seedance-2-0-app-to-seedance-2-5 -->

# Come migrare un'app Seedance 2.0 a Seedance 2.5 su AtlasCloud

> Passare il tuo progetto personale Seedance 2.0 alla versione 2.5 su Atlas Cloud è principalmente una modifica dell'ID del modello su una riga, più un ricontrollo del budget a $0,134 al secondo.

Se hai già qualcosa che funziona su Seedance 2.0, migrarlo a Seedance 2.5 su Atlas Cloud è, per la maggior parte dei progetti individuali, una modifica su una riga: sostituire la stringa `model` nel corpo della richiesta con `bytedance/seedance-2.5/text-to-video`, `bytedance/seedance-2.5/image-to-video` o `bytedance/seedance-2.5/reference-to-video`. L'endpoint, l'header di autenticazione e la struttura submit-then-poll rimangono gli stessi. Ciò che merita veramente la tua attenzione sono tre cose: le clip possono ora durare fino a 30 secondi invece di pochi, la generazione audio è attiva per impostazione predefinita e il prezzo è di $0,134 al secondo di video generato, quindi ogni cifra che hai annotato per la vecchia versione è ora sbagliata e deve essere ricalcolata.

Questa pagina illustra quella migrazione nel modo in cui una persona con una carta di credito e un progetto personale la farebbe effettivamente, non nel modo in cui lo farebbe un team di piattaforma. Ogni cifra qui sotto proviene dalle pagine dei modelli Atlas Cloud e dallo schema JSON pubblicato di Seedance 2.5 così come si leggono al 24-08-2026.

## La migrazione più piccola possibile: cambia una stringa

Il video su Atlas Cloud non è l'endpoint chat compatibile con OpenAI. Questo confonde le persone, quindi vale la pena dirlo chiaramente prima di ogni altra cosa: non chiami il video con `from openai import OpenAI` e `chat.completions`. Quel codice non può essere eseguito su un modello video. La superficie compatibile con OpenAI su Atlas Cloud copre il catalogo di modelli di testo e linguaggio, la chiave API condivisa e la fatturazione condivisa. Il video è un proprio flusso REST a due passaggi.

Il flusso è: invia un job, ottieni un ID di richiesta indietro, quindi effettua il polling fino a quando non finisce e ti restituisce un URL del file. Se la tua app 2.0 funziona oggi, hai già scritto questo ciclo. Eccolo per intero, già puntato alla versione 2.5:

```python
import os, time, requests

BASE = "https://api.atlascloud.ai"
HEADERS = {
    "Authorization": f"Bearer {os.environ['YOUR_API_KEY']}",
    "Content-Type": "application/json",
}

#1. Submit the job
job = requests.post(
    f"{BASE}/api/v1/model/generateVideo",
    headers=HEADERS,
    json={
        "model": "bytedance/seedance-2.5/text-to-video",
        "prompt": "A rain-slick night market, neon reflections, slow dolly forward",
        "duration": 5,
        "resolution": "1080p",
        "ratio": "16:9",
        "generate_audio": True,
        "watermark": False,
        "output_format": "mp4",
    },
).json()

request_id = job["request_id"]

#2. Poll until it is done
while True:
    state = requests.get(
        f"{BASE}/api/v1/model/prediction/{request_id}", headers=HEADERS
    ).json()
    if state.get("status") in ("succeeded", "failed"):
        print(state)
        break
    time.sleep(5)
```

Se il tuo codice 2.0 esistente assomiglia strutturalmente a quello, sei quasi finito. Cambia il valore di `model`, rileggi la sezione dei parametri qui sotto ed esegui una clip di prova economica prima di toccare qualsiasi altra cosa.

## Quale dei tre ID modello 2.5 sostituisce quello che stavi usando

Seedance 2.5 è pubblicato come tre ID modello separati piuttosto che un modello con un flag di modalità. Abbinali a come la tua app costruisce la sua richiesta:

| Se la tua app 2.0 invia | Usa questo ID modello Seedance 2.5 | Prezzo |
|---|---|---|
| Solo un prompt di testo | `bytedance/seedance-2.5/text-to-video` | $0,134 / secondo |
| Un'immagine fissa iniziale più un prompt | `bytedance/seedance-2.5/image-to-video` | $0,134 / secondo |
| Immagini, video o audio di riferimento che la clip dovrebbe imitare | `bytedance/seedance-2.5/reference-to-video` | $0,134 / secondo |

Tutti e tre costano esattamente lo stesso, il che semplifica la decisione: scegli puramente in base a ciò che stai fornendo, mai in base al prezzo. Non c'è una variante 2.5 più economica da cercare. Se qualcuno ti dice di scegliere un particolare endpoint 2.5 per risparmiare denaro, si sbaglia.

Una nota sulla formulazione mentre siamo qui, perché conta se scrivi qualcosa di pubblico sul tuo strumento: Seedance 2.5 non è "il Seedance più economico". Atlas Cloud elenca ancora i livelli Pro più vecchi, e il meno costoso di tutti è `bytedance/seedance-v1.5-pro/text-to-video-fast` a $0,01 al secondo. La 2.5 è il livello più recente e più capace, non quello economico.

## Rifai il costo per clip prima di premere l'interruttore

Questa è la parte della migrazione che le persone saltano e poi rimpiangono. Seedance 2.5 fattura a $0,134 al secondo di video generato su Atlas Cloud, senza alcuno sconto applicato al momento della scrittura. Tradotto in clip che un creatore produce effettivamente:

| Lunghezza clip | Costo a $0,134 al secondo |
|---|---|
| 5 secondi (predefinito) | $0,67 |
| 10 secondi | $1,34 |
| 30 secondi (il massimo) | $4,02 |

Ora confronta con le tue abitudini reali. Se il tuo flusso di lavoro è "genera cinque variazioni, tieni una", una singola ripresa finita da 5 secondi ti costa circa tre dollari e mezzo in tentativi, non sessantasette centesimi. Se pubblichi tre clip da 10 secondi a settimana, ciò si traduce in circa sedici dollari al mese solo per i rendering riusciti, prima dei take scartati. Fai un budget per clip finita, non per chiamata API. Questo è il cambio mentale più utile quando passi a un livello superiore.

E la cifra esatta al secondo che la tua configurazione 2.0 è stata addebitata? Non la citeremo qui, perché non è nello snapshot dei prezzi verificato su cui è costruito questo articolo, e inventare un numero di confronto sarebbe peggio che inutile quando stai cercando di pianificare un budget. Tratta la vecchia tariffa 2.0 come Non pubblicata ai fini di questa pagina, e invece fai la versione onesta del confronto: apri la cronologia di fatturazione di Atlas Cloud, prendi quanto hai effettivamente speso il mese scorso, guarda la lunghezza media della tua clip e moltiplicala per lo stesso volume a $0,134 al secondo. Questo ti dà il tuo delta reale piuttosto che uno di marketing.

Per riferimento, i vecchi livelli Seedance Pro che sono ancora elencati si situano significativamente più bassi, con `bytedance/seedance-v1-pro-t2v-1080p` a $0,11 al secondo, `bytedance/seedance-v1.5-pro/text-to-video` a $0,047 al secondo e la variante veloce a $0,01 al secondo. Alcuni creatori mantengono ragionevolmente un livello economico collegato per le bozze e chiamano 2.5 solo per il take finale. Questo è un modello legittimo e ti costa nient'altro che una condizionale nel tuo codice.

## Durata: le tue clip possono ora essere molto più lunghe, e questo cambia la fattura

Su Seedance 2.5, `duration` accetta secondi interi da 4 a 30, con un predefinito di 5. Puoi anche passare -1 per lasciare che il modello scelga una lunghezza adatta al prompt.

La trappola qui non è tecnica, è finanziaria. Se la tua app 2.0 aveva una durata breve codificata e ora esponi uno slider fino a 30 secondi, il tuo costo per generazione può moltiplicarsi per sei con un solo trascinamento dell'utente. A $0,134 al secondo, un rendering da 30 secondi è di $4,02. Se stai costruendo qualcosa su cui altre persone possono premere un pulsante, limita la durata nel tuo codice a qualunque cosa tu possa permetterti, e aumentala solo deliberatamente.

L'opzione -1 è genuinamente utile per un creatore indipendente che fa clip una tantum per se stesso, perché il modello adatta la lunghezza all'azione descritta invece di tagliare a metà gesto. È una cattiva idea in qualsiasi app con un pulsante pubblico, poiché non puoi prevedere la fattura in anticipo.

## L'audio è attivo per impostazione predefinita ora, ed è il default a più alto rischio

`generate_audio` è un booleano e per impostazione predefinita è **true**. Seedance 2.5 produce audio nativo sincronizzato: dialoghi, effetti sonori e musica, generati insieme all'immagine piuttosto che doppiati successivamente.

Per un creatore questo è spesso il singolo miglior motivo per migrare. Le tue clip arrivano con una colonna sonora invece di arrivare silenziose e richiedere un passaggio di modifica.

Per un'app esistente è la cosa più probabile che rompa qualcosa silenziosamente. Pensa a cosa fa il tuo codice 2.0 con l'MP4 restituito:

- Se cuci clip insieme e sovrapponi la tua musica, ora mescolerai due colonne sonore.
- Se mostri clip in un feed che si riproduce automaticamente, gli utenti potrebbero improvvisamente sentire voci dove non le sentivano mai.
- Se ricodifichi l'output e la tua pipeline elimina i flussi audio, stai pagando per l'audio che butti via.

L'ordine di migrazione sicuro è: imposta esplicitamente `generate_audio: false` nella tua prima richiesta 2.5 in modo che l'interruttore sia neutrale rispetto al comportamento, conferma che tutto funzioni ancora, quindi attiva l'audio come cambiamento separato e deliberato con il proprio round di test. Due piccoli cambiamenti su cui puoi ragionare battono un grande cambiamento su cui non puoi.

## Risoluzione e rapporto d'aspetto, e il problema su image-to-video

L'enum di risoluzione su Seedance 2.5 offre `480p`, `720p` (predefinito) e `1080p` nativi, più un set di opzioni upscale. Gli upscale sono contrassegnati `-sr`, che significa super-risoluzione FlashVSR, e `-esr`, che significa Atlas Video Enhance ESR. Questi sono passaggi di miglioramento applicati sopra un rendering, non una generazione ad alta risoluzione nativa, quindi se prometti al tuo pubblico un deliverable `4k-esr`, sii preciso su cosa sia. `1080p-esr & 60fps` si trova nella stessa famiglia upscale.

In pratica, la maggior parte dei creatori indipendenti dovrebbe rimanere su `1080p` nativo per qualsiasi cosa vada su YouTube o a un cliente, e `720p` nativo per bozze e contenuti social-first. Entrambi appaiono bene su un telefono. `480p` esiste ed è una scelta ragionevole per rapidi test di composizione dove ti interessa solo se il movimento della telecamera funziona.

Il parametro del rapporto d'aspetto accetta `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9` e `adaptive`, con `adaptive` come predefinito. Ecco il problema che cattura le migrazioni:

**Image-to-video accetta solo `adaptive`.** L'output prende il rapporto d'aspetto dell'immagine sorgente che fornisci. Se la tua app 2.0 ha un toggle per video verticale che invia `9:16` insieme a un'immagine di input, quella forma di richiesta non si applica su Seedance 2.5 image-to-video. La correzione non è nella chiamata API, è a monte: ritaglia o riempi la tua immagine sorgente alla forma che vuoi che il video sia, e lascia che `adaptive` la segua. Text-to-video e reference-to-video non sono interessati e possono ancora prendere un rapporto esplicito.

## Input di riferimento: i numeri reali sono 30 immagini, 10 video, 10 audio

Se sei su `reference-to-video`, è qui che 2.5 diventa interessante. Un input di riferimento è un file che consegni al modello come esempio di ciò che vuoi, il volto di un personaggio, una stanza, uno stile di telecamera, una voce, piuttosto che descriverlo a parole e sperare.

I limiti pubblicati sono:

| Tipo di riferimento | Massimo | Note |
|---|---|---|
| Immagini di riferimento | 30 | URL, Base64, o `asset://<ASSET_ID>` |
| Video di riferimento | 10 | citati in ordine di invio |
| Audio di riferimento | 10 | wav o mp3, da 2 a 30 secondi ciascuno, massimo 15MB per file |

Li indirizzzi dall'interno del prompt in ordine di invio usando la sintassi @: `@Image1`, `@Video1`, `@Audio1`. Quindi un prompt come "la donna in @Image1 cammina attraverso il corridoio di @Image2, parlando con la voce di @Audio1" è una cosa normale da scrivere.

Circolano articoli più vecchi con un tetto di immagini molto più alto. Ignorali: lo schema live dice 30. Se il tuo codice 2.0 ha un controllo di validazione codificato a qualche altro numero, aggiornalo ora piuttosto che scoprirlo tramite un job fallito.

Due flag minori che vale la pena conoscere mentre sei nell'elenco dei parametri: `watermark` è predefinito su false, e `return_last_frame` è predefinito su false. Quest'ultimo è genuinamente utile per un creatore che concatena riprese, poiché il frame finale della clip uno può diventare l'immagine di input per la clip due, dandoti continuità attraverso una sequenza senza ridescrivere la scena.

## Un ordine di migrazione che non sprecherà denaro

Fallo in quest'ordine e la tua spesa totale per la migrazione sarà un paio di dollari:

1. **Leggi la pagina del modello.** Conferma tu stesso il prezzo attuale sulla [pagina del modello Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5) prima di pianificare un budget. I prezzi cambiano; gli articoli invecchiano.
2. **Cambia solo la stringa del modello.** Mantieni durata, risoluzione e rapporto esattamente come li aveva la tua app 2.0, e aggiungi `generate_audio: false` in modo che nulla sulla forma dell'output cambi.
3. **Esegui una clip da 5 secondi.** Sono $0,67. Controlla che il file venga riprodotto, controlla che il percorso di download e archiviazione funzioni ancora, controlla che il tuo ciclo di polling riconosca ancora lo stato finito.
4. **Attiva l'audio.** Esegui lo stesso prompt di nuovo con `generate_audio: true`. Ascoltalo. Decidi se migliora il tuo output o combatte la tua modifica esistente.
5. **Estendi la durata per ultimo.** Prova 10 secondi ($1,34) prima di provare mai 30 secondi ($4,02). I prompt più lunghi richiedono più direzione, e una cattiva clip da 30 secondi costa sei volte quella che costa una cattiva clip da 5 secondi.
6. **Ricalcola il tuo budget mensile** da numeri reali, non dal caso migliore.

Costo totale di una migrazione attenta seguendo questi passaggi: pochi dollari, circa il prezzo di un caffè, e saprai esattamente a cosa stai passando.

E non sei bloccato. Atlas Cloud esegue un account e una chiave API su tutto il suo catalogo, quindi mantenere un vecchio livello Seedance collegato per le bozze accanto a 2.5 per i finali non ti costa alcuna configurazione extra. Puoi sfogliare i vecchi livelli sulla [pagina della famiglia Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5), vedere tutto disponibile sull'[elenco completo dei modelli](https://www.atlascloud.ai/models/all?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5) e controllare le tariffe attuali sulla [pagina dei prezzi](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5).

Sulla domanda che tutti fanno poi, che è se 2.5 è più veloce o più lenta di quello che hai: Non pubblicato. Atlas Cloud non pubblica latenza di generazione o tempi di coda per i modelli video, e non abbiamo eseguito un benchmark per questo articolo, quindi non indovineremo. Se ti interessa, misuralo tu stesso: esegui gli stessi cinque prompt su entrambi, marca temporalmente la tua chiamata di submit e il tuo primo polling riuscito, e confronta le mediane. Ciò richiede una sera e circa dieci dollari e ti dà una risposta sui tuoi prompt piuttosto che su quelli di qualcun altro.

Allo stesso modo, sulla licenza e ciò che ti è consentito fare commercialmente con l'output: questo articolo non ha verificato i termini commerciali di alcun fornitore. Leggi i termini di ByteDance e Atlas Cloud prima di mettere una clip generata davanti a un cliente pagante.

## FAQ

D: Seedance 2.5 è una sostituzione drop-in per 2.0 nel mio codice?
R: Il trasporto è identico, quindi strutturalmente sì: stesso POST a /api/v1/model/generateVideo, stesso polling su /api/v1/model/prediction/{request_id}, stesso header di autenticazione. Le tre cose che possono sorprenderti sono il default dell'audio che passa a true, il tetto della durata che sale a 30 secondi e il prezzo di $0,134 al secondo.

D: Invio un'immagine di input e un rapporto 9:16 oggi. Funzionerà ancora?
R: La variante image-to-video accetta solo `adaptive` per il rapporto, perché l'output segue la tua immagine sorgente. Ritaglia la tua immagine di input a 9:16 prima di caricarla e otterrai l'output verticale che volevi.

D: Come faccio a impedire a 2.5 di aggiungere suono?
R: Invia `"generate_audio": false` nel corpo della richiesta. È predefinito su true, quindi devi dirlo esplicitamente.

D: Quanto può costarmi al massimo una singola generazione?
R: La clip più lunga è di 30 secondi, che a $0,134 al secondo è di $4,02. Limita il valore della durata nel tuo codice se chiunque diverso da te può attivare un rendering.

D: Dovrei spostare tutto su 2.5 o tenere il vecchio livello?
R: Molti creatori indipendenti mantengono entrambi. Fai bozze su un livello più economico come `bytedance/seedance-v1.5-pro/text-to-video` a $0,047 al secondo, quindi renderizza il keeper su 2.5. Una chiave API copre entrambi, quindi è una condizionale nel tuo codice, non un secondo account.

D: Ci sono limiti di frequenza intorno ai quali dovrei progettare?
R: Non pubblicato. Nessun host API video che abbiamo controllato pubblica limiti di richieste al minuto o concorrenza, Atlas Cloud incluso. Scrivi il tuo ciclo di polling con backoff e retry in caso di fallimento, che è una buona pratica indipendentemente da quale risulti essere il limite.

## La conclusione

Per un creatore indipendente con un progetto Seedance 2.0 funzionante, questa migrazione è una stringa e un pomeriggio. Punta `model` alla variante 2.5 che corrisponde al tuo input, imposta esplicitamente `generate_audio: false` in modo che il tuo primo test non cambi nient'altro, spendi $0,67 su una clip da 5 secondi per provare che la pipeline funzioni ancora, e solo allora inizia a goderti le nuove capacità: audio nativo, clip fino a 30 secondi e fino a 30 immagini di riferimento con 10 video e 10 clip audio per guidare l'aspetto.

La parte che merita vera riflessione non è il codice, è l'aritmetica. A $0,134 al secondo, $4,02 per un rendering da 30 secondi è facile da attivare e facile da ripetere quando stai iterando. Imposta un limite di durata, conta i tuoi take scartati come parte del costo di una clip finita e controlla la pagina del modello per la tariffa corrente prima di impegnarti su un numero mensile. Fai quello e 2.5 è un aggiornamento semplice piuttosto che una sorpresa sulla tua carta.