Använd Wan 3.0 Video via Rivyas publika API v1 med modell-ID wan-3-0-video, 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

wan-3-0-video

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

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⌉

Förmåga

Video

Fakturering

METERED

Promptgräns

20000 tecken

Kontrakt för begäran

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

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	wan-3-0-video	Använd API-modell-ID:t wan-3-0-video.
prompt	string	Ja	-	Högst 20000 tecken för den här modellen.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
seedance_scene	select	Nej	text	-	text, frames, reference	Välj ett ömsesidigt uteslutande indatakontrakt innan du laddar upp medier.
variant	select	Nej	standard	-	standard, prime	Standard och Prime använder samma kontroller men olika avgifter per sekund.
resolution	select	Nej	1080P	-	480P, 720P, 1080P	Reservationen är priset för variant och upplösning multiplicerat med summan av verifierade sekunder inmatningsvideo och reserverade utdatasekunder; totalen avrundas uppåt en gång. Intelligent varaktighet reserverar 30 utdatasekunder och kan inte användas med referensvideo.
aspect_ratio	select	Nej	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Välj adaptiv inramning eller ett fast bildförhållande för utdata.
duration	number	Nej	5	min -1 / max 30 / step 1	-	Välj -1 för intelligent längd eller ett heltal från 2 till 30 sekunder. Intelligent längd reserverar 30 utdatasekunder och kan inte användas med referensvideo.
audio	select	Nej	true	-	true, false	Välj om den genererade videon ska innehålla ljud som skapats av modellen.
seed	number	Nej	-	min 0 / max 2147483647 / step 1	-	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.

Uppladdningspolicy

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

Referensregel

Vägledande bildrutor eller signerade multimodala referenser: Bildruteläget tar emot en obligatorisk första bild och en valfri sista bild. Referensläget tar emot upp till 10 JPEG-bilder, PNG-bilder utan transparens, WebP- eller BMP-bilder på 20 MB styck, 5 MP4/MOV-videor på 95 MB och 1–15 sekunder styck samt 5 MP3/WAV-ljudklipp på 15 MB och 1–15 sekunder styck; den sammanlagda längden för video respektive ljud begränsas separat till 15 sekunder.

Max filer

Godkända filtyper

image, video, audio

Varaktighetstoken

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

kind	Max storlek	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 begäran

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

Begäran med referensfil

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

Skapa-svar

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

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

Wan 3.0 Video API-integration