Brug Wan 3.0 Video via Rivya Public API v1 med model-id wan-3-0-video, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIVideo

API-model-id

wan-3-0-video

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Funktion

Video

Fakturering

METERED

Promptgrænse

20000 tegn

Anmodningskontrakt

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

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	wan-3-0-video	Brug API-model-id'et wan-3-0-video.
prompt	string	Ja	-	Maksimalt 20000 tegn for denne model.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
seedance_scene	select	Nej	text	-	text, frames, reference	Vælg én gensidigt udelukkende inputkontrakt, før du uploader medier.
variant	select	Nej	standard	-	standard, prime	Standard og Prime bruger de samme kontroller, men forskellige satser pr. sekund.
resolution	select	Nej	1080P	-	480P, 720P, 1080P	Reservationen er satsen for variant og opløsning ganget med summen af verificerede inputvideosekunder og reserverede outputsekunder; totalen rundes op én gang. Intelligent varighed reserverer 30 outputsekunder og kan ikke bruges med referencevideo.
aspect_ratio	select	Nej	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Vælg adaptiv beskæring eller ét fast billedformat for output.
duration	number	Nej	5	min -1 / max 30 / step 1	-	Vælg -1 for intelligent varighed eller et helt tal fra 2 til 30 sekunder. Intelligent varighed reserverer 30 outputsekunder og kan ikke bruges med referencevideo.
audio	select	Nej	true	-	true, false	Vælg, om den genererede video skal indeholde lyd, der er skabt af modellen.
seed	number	Nej	-	min 0 / max 2147483647 / step 1	-	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.

Uploadpolitik

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

Referenceregel

Vejledende billeder eller signerede multimodale referencer: Billedtilstanden accepterer ét obligatorisk første billede og ét valgfrit sidste billede. Referencetilstanden accepterer op til 10 JPEG-billeder, PNG-billeder uden gennemsigtighed, WebP- eller BMP-billeder på 20 MB hver, 5 MP4/MOV-videoer på 95 MB og 1–15 sekunder hver samt 5 MP3/WAV-lydklip på 15 MB og 1–15 sekunder hver; den samlede varighed for video og lyd begrænses separat til 15 sekunder.

Maks. filer

Accepterede filtyper

image, video, audio

Duration-token

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

kind	Maks. størrelse	MIME-typer
image	20 MB	image/jpeg, image/png, image/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimal anmodning

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Referencefilanmodning

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Oprettelsessvar

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

{
  "id": "task_wan_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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.

Wan 3.0 Video API-integration