Rivya AI-dokumentation
Modellsidor för API

Seedance 1.0 Pro API-integration

Använd Seedance 1.0 Pro via Rivyas publika API v1 med modell-ID seedance-1-0-pro, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIVideo
API-modell-ID

seedance-1-0-pro

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

25

Förmåga

Video

Fakturering

FIXED

Promptgräns

10000 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

NyckelTypObligatorisktStandardBeskrivning
modelstringJaseedance-1-0-proAnvänd API-modell-ID:t seedance-1-0-pro.
promptstringJa-Högst 10000 tecken för den här modellen.
paramsobjectNej-Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_idstringNej-Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

NyckelTypObligatorisktStandardIntervallAlternativBeskrivning
resolutionselectNej720p-480p, 720p, 1080pUpplösning
durationselectNej5-5, 10Varaktighet
aspect_ratioselectNej16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16Bildförhållande
camera_fixedselectNejfalse-false, trueStyr om tagningen ska bete sig mer som en fast kamera. När det är aktiverat blir kamerarörelsen mer återhållen; när det är inaktiverat tillåts tydligare rörelse.
seednumberNej-1min -1 / max 2147483647-Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte.
enable_safety_checkerselectNejtrue-true, falseSäkerhetskontroll

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbild: Ladda upp 1 bildfil för bild-till-video-körningar.

Max filer

1

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kindMax storlekMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal begäran

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

Begäran med referensfil

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

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.