Seedance 2.5

Seedance 2.5 è il modello di generazione video più recente di ByteDance (Dreamina Seedance 2.5). Invia il corpo dell'attività ufficiale ModelArk, conserva l'identificativo dell'attività restituito e leggi il video finito dall'attività. Immagini, video e audio vanno in content come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

curl https://api.seedrouter.ai/v1/contents/generations/tasks \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5",
    "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

Endpoint

POST https://api.seedrouter.ai/v1/contents/generations/tasks

Il corpo è la richiesta ufficiale ModelArk «crea un'attività di generazione video». Se chiami già ModelArk, cambia solo l'URL di base in https://api.seedrouter.ai/v1 e la chiave API. La risposta è {"id": "task_..."}, non il video finito. Tieni le chiavi API nel codice lato server.

Parametri

Elementi di content

I campi sconosciuti vengono rifiutati. Non supportati: seed, callback_url (interroga invece l'attività), draft e draft_task, tools e i parametri frames e camera_fixed esclusivi di 1.x. Le attività non possono essere annullate né eliminate.

Modalità

La modalità dipende dagli elementi di content; non esiste un parametro di modalità.

Le modalità con primo fotogramma non possono essere combinate con elementi di riferimento. Con più immagini o con altri media, ogni immagine richiede un role.

Esempio con riferimenti

curl https://api.seedrouter.ai/v1/contents/generations/tasks \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5",
    "content": [
      {"type": "text", "text": "The character from the image walks through the market in the video, same camera move"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/market.mp4"}, "role": "reference_video"}
    ],
    "ratio": "adaptive",
    "duration": 8
  }'

Sostituisci gli URL di esempio con file tuoi accessibili.

Input multimediali

Questa API accetta solo riferimenti tramite URL. Non sono accettati base64, URL data:, identificativi asset:// e caricamenti multipart. Il Playground carica i file selezionati nello storage prima di inviarne gli URL.

I media devono essere URL HTTP(S) pubblici e rispettare i limiti ufficiali del modello:

Il modello non supporta immagini e video di riferimento che contengono volti umani reali.

I media vengono controllati all'avvio dell'attività, prima di qualsiasi generazione. Un'attività i cui media violano uno di questi limiti termina come failed con invalid_request_error e un messaggio che indica la regola, ad esempio The request was rejected: content reference videos must total at most 15 seconds., e non viene addebitata. Un file che in quel momento non può essere letto viene passato al modello, che lo accetta o lo rifiuta; in entrambi i casi un'attività fallita non viene addebitata.

Fattori di costo

Consulta la sezione prezzi del modello per le tariffe correnti. Seedance 2.5 fattura i token video, l'unità ufficiale:

video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024

La tariffa per milione di token dipende dalla risoluzione di output e dalla presenza di un video di riferimento nella richiesta; una richiesta con video di riferimento applica una tariffa più bassa a tutti i suoi token. Gli input di testo, immagine e audio non vengono fatturati. In 16:9, un secondo corrisponde a 9.607,5 token a 480p (854×480), 21.600 a 720p, 48.600 a 1080p.

L'addebito segue i token dichiarati dal video finito (usage.completion_tokens), quindi duration: -1 viene fatturato sulla durata effettivamente generata. Le clip renderizzate durano leggermente più di quanto richiesto: una richiesta di 5 secondi a 720p in 16:9 renderizza 121 fotogrammi e dichiara 108.900 token anziché 108.000. Gli addebiti definitivi sono nello storico di utilizzo del tuo account. Le attività fallite e scadute non vengono addebitate.

Schema di output

L'invio restituisce l'identificativo dell'attività:

{"id": "task_..."}

Recuperare l'attività

curl https://api.seedrouter.ai/v1/contents/generations/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Interroga ogni 10–20 secondi finché status non diventa succeeded, failed o expired. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l'identificativo dell'attività e riprendi il controllo. Non creare un'altra attività per verificare l'avanzamento.

Esempio di polling completo

Esegui questo dopo l'esempio di invio in Python qui sopra.

import time

deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
    result = requests.get(
        f"https://api.seedrouter.ai/v1/contents/generations/tasks/{task_id}",
        headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
        timeout=30,
    )
    result.raise_for_status()
    task = result.json()
    if task["status"] == "succeeded":
        print(task["content"]["video_url"])
        break
    if task["status"] in ("failed", "expired"):
        raise RuntimeError(task["error"]["message"])
    time.sleep(15)
else:
    raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")

Attività riuscita

{
  "id": "task_...",
  "model": "dreamina-seedance-2-5",
  "status": "succeeded",
  "content": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg"
  },
  "usage": {"completion_tokens": 108900, "total_tokens": 108900},
  "seed": 42,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "draft": false,
  "output_format": "mp4",
  "service_tier": "default",
  "execution_expires_after": 172800,
  "priority": 0,
  "created_at": 1790321515,
  "updated_at": 1790321652
}

Gli URL dei video sono ospitati sul nostro storage. Salva il file nel tuo storage se ti serve una copia duratura.

Elencare le attività

curl "https://api.seedrouter.ai/v1/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Restituisce {"total": N, "items": [...]} con gli oggetti attività degli ultimi 7 giorni, dal più recente. page_num e page_size accettano valori 1–500 (predefiniti 1 e 20). Filtri: filter.status, filter.model, filter.task_ids (ripetibile) e filter.service_tier.

Errori

Le richieste rifiutate prima della creazione di un'attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un'attività che fallisce dopo l'accettazione restituisce HTTP 200 all'interrogazione, con status: "failed" (o "expired") e un oggetto error. L'output bloccato dal filtro dei contenuti fallisce con content_policy_violation; un'attività che supera execution_expires_after termina come expired con task_expired.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "id": "task_...",
  "model": "dreamina-seedance-2-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se è l'invio stesso ad andare in timeout, controlla l'elenco delle attività prima di inviare di nuovo: la prima richiesta potrebbe essere già stata accettata.

Suggerimenti

• Descrivi il soggetto, l'azione, il movimento di camera e l'illuminazione con frasi complete.
• Fai le bozze a 480p con una duration breve, poi renderizza la versione scelta a una risoluzione più alta.
• Concatena le inquadrature con return_last_frame: usa il fotogramma restituito come first_frame dell'attività successiva.
• Per modificare un filmato, imposta omni_reference_task_type su edit e descrivi solo ciò che deve cambiare.

Correlati

• Playground e prezzi di Seedance 2.5
• Scarica l'OpenAPI
• Markdown copiabile