Folosește Wan 3.0 Video prin Rivya Public API v1 cu model id wan-3-0-video, intrări suportate, parametri, reguli Files API, credite și exemple de răspuns.

Disponibil prin APIText sau URL gata; modurile de referință folosesc Files APIVideo

ID model API

wan-3-0-video

Intrări

text, file

Files API

Necesar pentru moduri de referință

Credite de bază

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⌉

Capabilitate

Video

Facturare

METERED

Limită prompt

20000 caractere

Contract cerere

Trimite model id la nivelul superior. Controalele specifice modelului aparțin în params.

Cheie	Tip	Necesar	Implicit	Descriere
model	string	Da	wan-3-0-video	Folosește ID-ul de model API wan-3-0-video.
prompt	string	Da	-	Maximum 20000 caractere pentru acest model.
params	object	Nu	-	Obiect de parametri specific modelului. Folosește rândurile de mai jos pentru cheile permise.
client_request_id	string	Nu	-	ID opțional din partea clientului pentru urmărirea cererilor în sistemul tău.

Parametri model

Cheie	Tip	Necesar	Implicit	Interval	Opțiuni	Descriere
seedance_scene	select	Nu	text	-	text, frames, reference	Alege un singur contract de intrare înainte de a încărca materiale.
variant	select	Nu	standard	-	standard, prime	Standard și Prime folosesc aceleași comenzi, dar tarife diferite pe secundă.
resolution	select	Nu	1080P	-	480P, 720P, 1080P	Rezervarea este tariful variantei și rezoluției înmulțit cu suma secundelor verificate ale videoclipului de intrare și a secundelor de ieșire rezervate; totalul este rotunjit o singură dată în sus. Durata inteligentă rezervă 30 de secunde de ieșire și nu este disponibilă cu videoclip de referință.
aspect_ratio	select	Nu	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Alege încadrarea adaptivă sau un raport de aspect fix pentru ieșire.
duration	number	Nu	5	min -1 / max 30 / step 1	-	Alege -1 pentru durată inteligentă sau un număr întreg de la 2 la 30 de secunde. Durata inteligentă rezervă 30 de secunde de ieșire și nu poate fi folosită cu video de referință.
audio	select	Nu	true	-	true, false	Alege dacă materialul video generat trebuie să includă sunet creat de model.
seed	number	Nu	-	min 0 / max 2147483647 / step 1	-	Lasă câmpul gol pentru un rezultat aleator nou de fiecare dată. Reutilizarea aceluiași număr întreg face mai ușoară reproducerea sau rafinarea unui rezultat anterior. Rezultatul rămâne mai apropiat doar când promptul și celelalte setări cheie rămân și ele similare, iar potrivirea 1:1 nu este garantată.

Politică de încărcare

Încarcă mai întâi fișierele de referință, apoi pune URL-ul returnat și duration token în params.referenceMediaItems.

Regulă referință

Cadre de ghidare sau referințe multimodale semnate: Scenariul cadre acceptă o primă imagine obligatorie și o ultimă imagine opțională. Scenariul referință acceptă până la 10 imagini JPEG, PNG fără transparență, WebP sau BMP de câte 20 MB, 5 materiale video MP4/MOV de câte 95 MB și 1–15 secunde și 5 clipuri audio MP3/WAV de câte 15 MB și 1–15 secunde; durata totală pentru video și audio este limitată separat la 15 secunde.

Max fișiere

Tipuri de fișiere acceptate

image, video, audio

Duration token

Referințele video și audio ar trebui să includă durationToken din /api/v1/files când verificarea duratei este necesară.

kind	Dimensiune max	Tipuri MIME
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

Cerere minimă

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

Cerere cu fișier de referință

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

Răspuns create

Endpointul create returnează un task id public. Interoghează endpointul de stare până când sarcina reușește sau eșuează.

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

Erori comune

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Unele moduri necesită încărcări de referință prin Files API.

Integrare API Wan 3.0 Video