# Seedance 2.0 API Riferimento API completo per i modelli di generazione video Seedance 2.0 di ByteDance. ## Varianti dei modelli Questa API supporta sei varianti: | Modello | ID | Descrizione | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Generazione video di alta qualità da testo | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Animazione delle immagini con controllo del movimento | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Generazione video guidata da video di riferimento | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Generazione video più rapida da testo | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Generazione video più rapida da immagini | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Generazione video guidata da riferimenti più rapida | ## Confronto rapido | Funzionalità | Modelli standard | Modelli Fast | |---------|-----------------|-------------| | Qualità | Qualità superiore | Ottimizzati per la velocità | | Tempo di elaborazione | 3-8 minuti | 1-4 minuti | | Intervallo di durata | 4-15 secondi | 4-15 secondi | | Opzioni di risoluzione | 480p, 720p, 1080p, 4k | 480p, 720p | | Media di riferimento | Immagini, video e audio per Reference-to-Video | Immagini, video e audio per Fast Reference-to-Video | ### Proporzioni supportate `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Opzioni di risoluzione | Risoluzione | Descrizione | |------------|-------------| | `480p` | Definizione standard, elaborazione più rapida | | `720p` | Alta definizione, equilibrio tra qualità e velocità | | `1080p` | Full HD, disponibile per tutti i modelli standard Seedance 2.0 | | `4k` | Ultra HD, disponibile per tutti i modelli standard Seedance 2.0 | ## Seedance 2.0 Da testo a video ### Punto di accesso ``` POST /api/v1/video/task ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"seedance-v2.0-text-to-video"` | | `prompt` | string | Prompt di generazione video | | `duration` | integer | Durata del video in secondi interi (4-15), con incrementi di 1 | | `resolution` | string | Risoluzione di uscita: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Proporzioni del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Facoltativi | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `sound` | boolean | Indica se generare il suono. Predefinito: `true`; non influisce sul prezzo | ### Esempio di richiesta ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 Da immagine a video ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"seedance-v2.0-image-to-video"` | | `prompt` | string | Prompt di generazione video | | `duration` | integer | Durata del video in secondi interi (4-15), con incrementi di 1 | | `resolution` | string | Risoluzione di uscita: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Proporzioni del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | | `image_url` | string | Primo fotogramma del video | #### Facoltativi | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `image_end_url` | string | URL facoltativo dell'immagine del fotogramma finale | | `sound` | boolean | Indica se generare il suono. Predefinito: `true`; non influisce sul prezzo | ### Esempio di richiesta ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 Da riferimenti a video ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Prompt di generazione video. Scrivi un prompt standard senza segnaposto oppure usa la funzione di riferimento @ (AT) con `<<>>`, `<<>>` e `<<>>` per richiamare esplicitamente gli elementi degli array di media corrispondenti | | `duration` | integer | Durata del video in secondi interi (4-15), con incrementi di 1 | | `resolution` | string | Risoluzione di uscita: `"480p"`, `"720p"`, `"1080p"` o `"4k"` | | `aspect_ratio` | string | Proporzioni del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Media di riferimento Invia 1-9 immagini. Le immagini possono essere omesse solo se viene fornito almeno un video di riferimento. | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `images` | string[] | 1-9 URL di immagini di riferimento, oppure un array vuoto quando `videos` non è vuoto | | `videos` | string[] | Fino a 3 URL di video di riferimento; ogni video deve durare 2-15 secondi, con durata totale massima di 15 secondi | | `audios` | string[] | Fino a 3 URL di audio di riferimento; ogni clip deve durare 2-15 secondi, con durata totale massima di 15 secondi; WAV o MP3, massimo 15 MB per clip; richiede almeno un'immagine o un video | #### Segnaposto di riferimento @ (AT) La funzione @ (AT) collega i media di riferimento al prompt tramite segnaposto numerati `<<<...>>>`. La numerazione inizia da `1` separatamente per ogni tipo di media e segue l'ordine del rispettivo array: | Segnaposto | Valore referenziato | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Ad esempio, se la prima immagine è un riferimento per il personaggio e la seconda per la scena, usa `<<>>` per il personaggio e `<<>>` per la scena in `prompt`. Ogni segnaposto deve indicare un elemento presente nel rispettivo array. #### Facoltativi | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `sound` | boolean | Indica se generare suono sincronizzato. Predefinito: `true` | ### Esempio di richiesta ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Esempio di richiesta Da riferimenti a video con @ (AT) ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Varianti Fast Le varianti Fast privilegiano la velocità di elaborazione. Tutti i modelli Fast supportano solo l'uscita `"480p"` e `"720p"`. Fast Da testo a video e Fast Da immagine a video seguono per il resto le strutture di richiesta dei rispettivi modelli standard, mentre Fast Da riferimenti a video usa gli stessi limiti dei media di riferimento del modello standard. ### Esempio di richiesta Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Esempio di richiesta Fast Da riferimenti a video con @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### Parametri Seedance 2.0 Fast Da riferimenti a video #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Prompt di generazione video. Scrivi un prompt standard senza segnaposto oppure usa la funzione di riferimento @ (AT) con `<<>>`, `<<>>` e `<<>>` per richiamare esplicitamente gli elementi degli array di media corrispondenti | | `duration` | integer | Durata del video in secondi interi (4-15), con incrementi di 1 | | `resolution` | string | Risoluzione di uscita: `"480p"` o `"720p"` | | `aspect_ratio` | string | Proporzioni del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` | #### Media di riferimento | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `images` | string[] | 1-9 URL di immagini di riferimento, oppure un array vuoto quando `videos` non è vuoto | | `videos` | string[] | Fino a 3 URL di video di riferimento; ogni video deve durare 2-15 secondi, con durata totale massima di 15 secondi | | `audios` | string[] | Fino a 3 URL di audio di riferimento; ogni clip deve durare 2-15 secondi, con durata totale massima di 15 secondi; WAV o MP3, massimo 15 MB per clip; richiede almeno un'immagine o un video | La stessa convenzione dei segnaposto con numerazione da 1 si applica anche al modello Fast Da riferimenti a video. #### Facoltativi | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `sound` | boolean | Indica se generare suono sincronizzato. Predefinito: `true` | ## Limiti dei media Questi limiti si applicano alle immagini del primo e dell'ultimo fotogramma e ai media di riferimento dei modelli in questa pagina. | Media | Formati | Limiti | |-------|---------|--------| | Immagini | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Ogni immagine deve essere inferiore a 30 MB; larghezza e altezza devono essere ciascuna di 300-6000 px; rapporto larghezza/altezza di 0.4-2.5 | | Video | MP4, MOV | Massimo 200 MB ciascuno; larghezza e altezza ciascuna di 300-6000 px; rapporto larghezza/altezza di 0.4-2.5; frequenza dei fotogrammi di 24-60 FPS | | Audio | WAV, MP3 | Massimo 15 MB ciascuno | | Corpo della richiesta | — | Massimo 64 MB | Audio e video di riferimento hanno ciascuno un limite separato di durata totale di 15 secondi. I conteggi sono indipendenti: fino a 9 immagini, 3 video e 3 clip audio. Aggiungere video non riduce il numero di immagini consentite. Tutti i modelli usano `720p` per impostazione predefinita, ma `resolution` deve comunque essere fornito. L'interruttore del suono è impostato su `true`; né questo né l'audio di riferimento modificano il prezzo. Da riferimenti a video richiede almeno un'immagine o un video; le richieste solo audio non sono supportate. Caricare video di riferimento raddoppia il costo di generazione, indipendentemente dal numero o dalla durata. ## Formato della risposta ### Risposta iniziale Tutti i modelli restituiscono un `task_id` per il polling: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Risposta di polling Interroga `GET /api/v1/video/{taskId}` per verificare lo stato: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Valori di stato - `submitted`: attività accettata e in attesa di elaborazione - `processing`: generazione video in corso - `succeed`: generazione video completata - `failed`: generazione video non riuscita ## Tempo di elaborazione **Modelli standard**: 3-8 minuti in base a durata e risoluzione. **Modelli Fast**: 1-4 minuti per la maggior parte delle configurazioni. Verifica lo stato ogni 5-10 secondi. ## Buone pratiche 1. **Scegliere la variante adatta**: usa modelli Fast per le iterazioni e modelli standard per l'uscita finale 2. **Descrivere chiaramente il movimento**: inserisci descrizioni specifiche dei movimenti nei prompt 3. **Scelta della risoluzione**: tutti i modelli standard Seedance 2.0 supportano `480p`, `720p`, `1080p` e `4k`; tutti i Fast supportano solo `480p` e `720p` 4. **Ordine dei riferimenti**: ordina intenzionalmente `images`, `videos` e `audios` e richiamali in modo coerente nel prompt 5. **Richieste solo video**: usa un array `images` vuoto solo quando fornisci almeno un video di riferimento 6. **Durata dei media**: mantieni ogni audio e video di riferimento tra 2 e 15 secondi 7. **Uso dell'audio**: ometti `sound` per usare il valore predefinito `true`, oppure impostalo su `false` per disattivare il suono generato