Rivya AI-dokumentation
Model-API-sider

Seedance 1.0 Pro API-integration

Brug Seedance 1.0 Pro via Rivya Public API v1 med model-id seedance-1-0-pro, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIVideo
API-model-id

seedance-1-0-pro

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

25

Funktion

Video

Fakturering

FIXED

Promptgrænse

10000 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

NøgleTypeKrævetStandardBeskrivelse
modelstringJaseedance-1-0-proBrug API-model-id'et seedance-1-0-pro.
promptstringJa-Maksimalt 10000 tegn for denne model.
paramsobjectNej-Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_idstringNej-Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

NøgleTypeKrævetStandardIntervalValgmulighederBeskrivelse
resolutionselectNej720p-480p, 720p, 1080pOpløsning
durationselectNej5-5, 10Varighed
aspect_ratioselectNej16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16Billedformat
camera_fixedselectNejfalse-false, trueStyrer, om skuddet skal opføre sig mere som et fast kamera. Når den er slået til, holdes kamerabevægelsen mere afdæmpet; når den er slået fra, tillades mere tydelig bevægelse.
seednumberNej-1min -1 / max 2147483647-Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.
enable_safety_checkerselectNejtrue-true, falseSikkerhedstjek

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencebillede: Upload 1 billedfil til billede-til-video-kørsler.

Maks. filer

1

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kindMaks. størrelseMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal anmodning

{
  "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"
  }
}

Referencefilanmodning

{
  "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"
      }
    ]
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

{
  "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
}

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.