Dokumentacja Rivya AI
Strony API modeli

Integracja API Wan 2.7 Video

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

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

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.

KluczTypWymaganeDomyślnieOpis
modelstringTakwan-2-7-videoUżyj wan-2-7-video jako identyfikatora modelu API.
promptstringTak-Maksymalnie 5000 znaków dla tego modelu.
paramsobjectNie-Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_idstringNie-Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

KluczTypWymaganeDomyślnieZakresOpcjeOpis
resolutionselectNie720p-720p, 1080pRozdzielczość
durationnumberNie5min 0 / max 15-text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s
aspect_ratioselectNie16:9-16:9, 9:16, 1:1, 4:3, 3:4Przebiegi 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_prompttextNie---prompt ≤ 5000; negative_prompt ≤ 500
prompt_extendselectNietrue-true, falseKontroluje, czy model przepisuje Twój prompt przed generowaniem. Zostaw włączone dla wygody albo wyłącz, gdy masz już bardzo precyzyjny prompt.
watermarkselectNiefalse-false, trueZnak wodny
audio_settingselectNieauto-auto, originKontroluje obsługę audio w ścieżce edycji wideo. Auto pozwala modelowi zdecydować, a Zachowaj oryginał próbuje zachować audio z wideo źródłowego.
seednumberNie-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: Media referencyjne: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

Maks. plików

2

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.

kindMaks. rozmiarTypy MIME
image30 MBimage/jpeg, image/png, image/webp
video30 MBvideo/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": "negative_prompt ≤ 500",
    "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": "negative_prompt ≤ 500",
    "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ę powodzeniem albo błędem.

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