Używaj Wan 2.7 Video przez Rivya Public API v1 z identyfikatorem modelu wan-2-7-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-2-7-video

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

Możliwość

Wideo

Rozliczenia

FIXED

Limit promptu

5000 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-2-7-video	Użyj wan-2-7-video jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 5000 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
resolution	select	Nie	720p	-	720p, 1080p	Rozdzielczość
duration	select	Nie	5	-	5, 10, 15	Przebiegi tekstowe i obrazowe mogą używać 5, 10 albo 15 sekund. Edycja wideo obecnie kończy się na 10 sekundach, a Rivya automatycznie normalizuje dłuższe wybory w tym trybie.
aspect_ratio	select	Nie	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Przebiegi tekst-na-wideo i edycji wideo używają tego bezpośrednio. Obraz-na-wideo obecnie podąża za geometrią przesłanego kadru zamiast udostępniać osobny przełącznik proporcji.
negative_prompt	text	Nie	-	-	-	Prompt negatywny
prompt_extend	select	Nie	true	-	true, false	Kontroluje, czy model przepisuje Twój prompt przed generowaniem. Zostaw włączone dla wygody albo wyłącz, gdy masz już bardzo precyzyjny prompt.
watermark	select	Nie	false	-	false, true	Znak wodny
audio_setting	select	Nie	auto	-	auto, origin	Kontroluje obsługę audio w ścieżce edycji wideo. Auto pozwala modelowi zdecydować, a Zachowaj oryginał próbuje zachować audio z wideo źródłowego.
seed	number	Nie	-	min 0 / max 2147483647	-	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

Media referencyjne: Prześlij maksymalnie 2 zasoby. Użyj do 2 obrazów dla obraz-na-wideo albo 1 wideo plus 1 opcjonalnego obrazu dla edycji wideo.

Maks. plików

Akceptowane rodzaje plików

image, video

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/webp
video	95 MB	video/mp4, video/quicktime

Żądanie minimalne

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Opcjonalne wykluczenia lub tryby porażki do uniknięcia.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Opcjonalne wykluczenia lub tryby porażki do uniknięcia.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpowiedź tworzenia

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

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "final_credits": 0,
  "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 2.7 Video