Documentazione Rivya AI
Pagine API per modello

Integrazione API di Seedance 1.0 Pro

Usa Seedance 1.0 Pro tramite Rivya Public API v1 con model id seedance-1-0-pro, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APITesto o URL pronti; le modalità di riferimento usano Files APIVideo
ID modello API

seedance-1-0-pro

Input

text, file

Files API

Richiesto per le modalità con riferimento

Crediti base

25

Capacità

Video

Fatturazione

FIXED

Limite prompt

10000 caratteri

Contratto della richiesta

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

KeyTipoObbligatorioPredefinitoDescrizione
modelstringseedance-1-0-proUsa seedance-1-0-pro come ID modello API.
promptstring-Massimo 10000 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
resolutionselectNo720p-480p, 720p, 1080pRisoluzione
durationselectNo5-5, 10Durata
aspect_ratioselectNo16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16Proporzioni
camera_fixedselectNofalse-false, trueControlla se l'inquadratura deve comportarsi più come una camera fissa. Attivandolo, il movimento camera resta più contenuto; disattivandolo, permette movimenti più evidenti.
seednumberNo-1min -1 / max 2147483647-Lascialo vuoto per ottenere ogni volta un nuovo risultato casuale. Riutilizzare lo stesso numero intero rende più semplice riprodurre o rifinire un risultato precedente. Il risultato resta più vicino solo quando anche il prompt e le altre impostazioni chiave rimangono simili, e non garantisce una corrispondenza 1:1.
enable_safety_checkerselectNotrue-true, falseControllo di sicurezza

Regola di upload

Carica prima i file di riferimento, poi inserisci l'URL restituito e il durationToken dentro params.referenceMediaItems.

Regola di riferimento

Immagine di riferimento: Carica 1 file immagine per le esecuzioni image-to-video.

File massimi

1

Tipi di file accettati

image

Duration token

I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.

kindDimensione massimaTipi MIME
image10 MBimage/jpeg, image/png, image/webp

Richiesta minima

{
  "model": "seedance-1-0-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Richiesta con file di riferimento

{
  "model": "seedance-1-0-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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_1_0_pro_example",
  "status": "queued",
  "model": "seedance-1-0-pro",
  "reserved_credits": 25,
  "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

Alcune modalità richiedono upload di riferimento tramite Files API.