Gebruik Wan 3.0 Video via Rivya Public API v1 met model-id wan-3-0-video, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIVideo

API-model-id

wan-3-0-video

Inputs

text, file

Files API

Vereist voor referentiemodi

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⌉

Mogelijkheid

Video

Facturering

METERED

Promptlimiet

20000 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	wan-3-0-video	Gebruik de API-model-id wan-3-0-video.
prompt	string	Ja	-	Maximaal 20000 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
seedance_scene	select	Nee	text	-	text, frames, reference	Kies één exclusief invoercontract voordat je media uploadt.
variant	select	Nee	standard	-	standard, prime	Standard en Prime gebruiken dezelfde instellingen, maar verschillende tarieven per seconde.
resolution	select	Nee	1080P	-	480P, 720P, 1080P	De reservering is het tarief voor variant en resolutie maal de som van geverifieerde invoervideoseconden en gereserveerde uitvoerseconden; het totaal wordt eenmaal naar boven afgerond. Intelligente duur reserveert 30 uitvoerseconden en is niet beschikbaar met referentievideo.
aspect_ratio	select	Nee	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Kies adaptieve kadrering of één vaste uitvoerverhouding.
duration	number	Nee	5	min -1 / max 30 / step 1	-	Kies -1 voor intelligente duur of een geheel getal van 2 tot 30 seconden. Intelligente duur reserveert 30 uitvoerseconden en kan niet met referentievideo worden gebruikt.
audio	select	Nee	true	-	true, false	Kies of de gegenereerde video door het model gemaakte audio moet bevatten.
seed	number	Nee	-	min 0 / max 2147483647 / step 1	-	Laat dit leeg voor elke keer een nieuw willekeurig resultaat. Door hetzelfde gehele getal opnieuw te gebruiken, wordt het makkelijker om een eerder resultaat te reproduceren of fijn af te stemmen. Het blijft alleen dichterbij wanneer de prompt en andere belangrijke instellingen ook vergelijkbaar blijven, en het is geen gegarandeerde 1-op-1 match.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Gidsframes of ondertekende multimodale referenties: Frames accepteert een verplichte eerste afbeelding en één optionele laatste afbeelding. Referentie accepteert maximaal 10 JPEG-, niet-transparante PNG-, WebP- of BMP-afbeeldingen van 20 MB, 5 MP4/MOV-video's van 95 MB en 1–15 seconden en 5 MP3/WAV-audioclips van 15 MB en 1–15 seconden; de totale duur van video en audio is elk beperkt tot 15 seconden.

Max. bestanden

Geaccepteerde bestandstypen

image, video, audio

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
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

Minimale request

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

Request met referentiebestand

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

Create-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

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

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Wan 3.0 Video API-integratie