DOCUMENTAZIONE PER SVILUPPATORI
Dal prompt al video, direttamente.
Questi esempi chiamano SeedanceLink. Usa la tua chiave API; la sessione di Google serve per la console web.
Prima di iniziare
Accedi, aggiungi credito sufficiente per il preventivo e crea una chiave in un gruppo con Seedance abilitato. L’esempio minimo qui sotto richiede 4 secondi a 480p.
Autenticazione
Invia Authorization: Bearer YOUR_API_KEY nelle richieste di creazione, stato e contenuto. Usa la stessa chiave che ha creato l’attività. Non inserire mai la chiave in un URL.
Authorization: Bearer YOUR_API_KEYhttps://seedancelink.ioSe omessi, la durata è di 5 secondi e la risoluzione di 720p. Questi esempi scelgono esplicitamente 4 secondi e 480p. Invia application/json e usa uno dei due ID modello della pagina dei modelli.
Esegui gli esempi curl nello stesso terminale macOS/Linux o Windows WSL. Il primo imposta la chiave e l’indirizzo API del sito. Mantieni segreta la chiave.
Crea un’attività
L’esempio richiede un video di 4 secondi. Salva l’id restituito. Seedance 2.0 supporta 4–15 secondi e Seedance 2.5 4–30. Entrambi supportano 480p, 720p e 1080p.
API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'
curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-933",
"content": [
{
"type": "text",
"text": "Una piccola barca attraversa un lago calmo all’alba, illuminazione cinematografica."
}
],
"duration": 4,
"resolution": "480p",
"ratio": "16:9"
}'Esempio di risposta
{
"id": "YOUR_TASK_ID",
"status": "queued"
}Salva l’ID dell’attività dalla risposta e usalo nei due passaggi successivi.
Controlla lo stato
Sostituisci REPLACE_WITH_RESPONSE_ID con quell’id. Controlla ogni 15 secondi durante attesa o esecuzione. Scarica con stato succeeded. Se failed o needs_reconcile, interrompi i controlli; per needs_reconcile contatta l’assistenza. Non inviare di nuovo automaticamente.
Esempio di risposta
{
"id": "YOUR_TASK_ID",
"status": "succeeded"
}Controlla circa ogni 15 secondi. Scarica solo quando lo stato è succeeded.
Scarica il video
Usa la stessa chiave che ha creato l’attività. L’endpoint protetto richiede la chiave Bearer; aprire l’URL nel browser non basta. curl segue i reindirizzamenti HTTPS senza condividere la chiave con altri host.
Stati e fatturazione
queued- Accettata e in attesa.
running- Generazione in corso.
succeeded- Completata; l’endpoint di contenuto autenticato è pronto.
failed- La generazione è fallita; l’importo riservato è stato restituito.
needs_reconcile- L’esito dell’invio è incerto; l’importo resta riservato per verifica.
Il preventivo precede la generazione.
Secondi richiesti × tariffa della risoluzione × moltiplicatore applicabile. L’importo viene riservato all’invio, addebitato in caso di successo e restituito in caso di errore.
Scarica con la stessa chiave
Dopo succeeded, usa content.video_url o l’endpoint di contenuto qui sotto con la tua chiave API. Un saldo residuo pari a zero non impedisce di scaricare un’attività già pagata.
Se l’esito dell’invio è incerto
Una ricevuta 202 con needs_reconcile contiene comunque un ID locale dell’attività. Conserva questo ID e controllalo. Non creare automaticamente un’altra attività: l’importo originale resta riservato.