Documentazione Rivya AI
Pagine API per modello

Integrazione API di Seedance 2.0

Usa Seedance 2.0 tramite Rivya Public API v1 con model id seedance-2, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APIInput testuale prontoVideo
ID modello API

seedance-2

Input

text

Files API

Non richiesto per la richiesta minima

Crediti base

175

Capacità

Video

Fatturazione

FIXED

Limite prompt

2500 caratteri

Contratto della richiesta

Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.

KeyTipoObbligatorioPredefinitoDescrizione
modelstringseedance-2Usa seedance-2 come ID modello API.
promptstring-Massimo 2500 caratteri per questo modello.
paramsobjectNo-Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_idstringNo-ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

KeyTipoObbligatorioPredefinitoIntervalloOpzioniDescrizione
seedance_sceneselectNotext-text, frames, referenceSeleziona quale percorso Seedance 2 eseguire: text-to-video puro, guida da primo frame / primo-ultimo frame, oppure generazione con riferimento multimodale.
resolutionselectNo720p-480p, 720pRisoluzione
aspect_ratioselectNo16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveProporzioni
durationnumberNo5min 4 / max 15-Durata
generate_audioselectNotrue-true, falseGenera audio
return_last_frameselectNofalse-false, trueRestituisce anche il frame finale come immagine statica, utile per copertine, run successivi o modifiche successive.
web_searchselectNofalse-false, trueRicerca web
nsfw_checkerselectNofalse-false, trueControllo NSFW

Richiesta minima

{
  "model": "seedance-2",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Risposta di creazione

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.

{
  "id": "task_seedance_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 175,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.