Używaj Wan 3.0 Video przez Rivya Public API v1 z identyfikatorem modelu wan-3-0-video, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIWideo

Identyfikator modelu API

wan-3-0-video

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

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⌉

Możliwość

Wideo

Rozliczenia

METERED

Limit promptu

20000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	wan-3-0-video	Użyj wan-3-0-video jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 20000 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
seedance_scene	select	Nie	text	-	text, frames, reference	Wybierz jeden wyłączny kontrakt wejściowy przed przesłaniem mediów.
variant	select	Nie	standard	-	standard, prime	Standard i Prime używają tych samych ustawień, ale mają różne stawki za sekundę.
resolution	select	Nie	1080P	-	480P, 720P, 1080P	Rezerwacja to stawka wariantu i rozdzielczości pomnożona przez sumę zweryfikowanych sekund filmu wejściowego i zarezerwowanych sekund wyjścia; całość jest raz zaokrąglana w górę. Inteligentny czas rezerwuje 30 sekund wyjścia i nie jest dostępny z filmem referencyjnym.
aspect_ratio	select	Nie	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Wybierz adaptacyjne kadrowanie albo jedne stałe proporcje wyniku.
duration	number	Nie	5	min -1 / max 30 / step 1	-	Wybierz -1 dla inteligentnego czasu albo liczbę całkowitą od 2 do 30 sekund. Inteligentny czas rezerwuje 30 sekund wyniku i nie może być używany z wideo referencyjnym.
audio	select	Nie	true	-	true, false	Wybierz, czy wygenerowane wideo ma zawierać audio utworzone przez model.
seed	number	Nie	-	min 0 / max 2147483647 / step 1	-	Pozostaw puste, aby za każdym razem uzyskać nowy losowy wynik. Ponowne użycie tej samej liczby całkowitej ułatwia odtworzenie albo dopracowanie poprzedniego wyniku. Wynik pozostaje bliższy tylko wtedy, gdy prompt i inne kluczowe ustawienia również pozostają podobne; nie jest to gwarantowane dopasowanie 1:1.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Klatki prowadzące lub podpisane referencje multimodalne: Scena klatek przyjmuje wymagany pierwszy obraz i jeden opcjonalny obraz końcowy. Scena referencji przyjmuje do 10 obrazów JPEG, PNG bez przezroczystości, WebP lub BMP po 20 MB, 5 wideo MP4/MOV po 95 MB i 1–15 sekund oraz 5 klipów audio MP3/WAV po 15 MB i 1–15 sekund; łączny czas wideo i audio jest osobno ograniczony do 15 sekund.

Maks. plików

Akceptowane rodzaje plików

image, video, audio

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy 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

Żądanie minimalne

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

Żądanie z plikiem referencyjnym

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

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

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

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Wan 3.0 Video