Dokumentacja Rivya AI
Strony API modeli

Integracja API Wan 2.2 A14B Turbo

Używaj Wan 2.2 A14B Turbo przez Rivya Public API v1 z identyfikatorem modelu wan-2-2-a14b-turbo, 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-2-a14b-turbo

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_output_second · 480p_standard_5s=40 · 580p_standard_5s=60 · 720p_standard_5s=80 · 480p_speech=12 · 580p_speech=18 · 720p_speech=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-2-a14b-turboUżyj wan-2-2-a14b-turbo 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-480p, 580p, 720p`480p / 580p / 720p` są dostępne dla uruchomień tekstowych, obrazowych oraz obrazu z dźwiękiem.
aspect_ratioselectNie16:9-16:9, 9:16Pozostaje dostępne tylko w text-to-video, ponieważ obecne publiczne endpointy image i image-plus-audio nie udostępniają stabilnego pola `aspect_ratio`.
enable_prompt_expansionselectNiefalse-false, trueWłącz, gdy chcesz, aby usługa upstream rozszerzyła ogólny prompt tekstowy przed generowaniem. Pozostaje ograniczone do uruchomień tekstowych i obrazowych.
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.
accelerationselectNienone-none, regularLżejsza kontrola przyspieszenia, która pozostaje ograniczona do publicznych trybów tekstowych i obrazowych.
num_framesnumberNie80min 40 / max 120 / step 4-Tylko dla ścieżki image-plus-audio. Prawidłowe wartości to 40 do 120, a liczba musi być podzielna przez 4. Typowy punkt startowy to 80.
frames_per_secondnumberNie16min 4 / max 60 / step 1-Tylko dla ścieżki image-plus-audio. Prawidłowe wartości to 4 do 60. Wyższe FPS zwykle daje płynniejsze wrażenie, ale zwiększa też presję generowania.
negative_prompttextNie---Tylko dla ścieżki image-plus-audio. Użyj go, aby opisać błędy ruchu, niechciane artefakty albo elementy wizualne, których chcesz uniknąć.
num_inference_stepsnumberNie27min 2 / max 40 / step 1-Tylko dla ścieżki image-plus-audio. Prawidłowe wartości to 2 do 40. Większa liczba kroków może poprawić jakość, ale zwiększa też czas działania.
guidance_scalenumberNie3.5min 1 / max 10 / step 0.1-Tylko dla ścieżki image-plus-audio. Prawidłowe wartości to 1 do 10. Wyższe wartości ściślej podążają za promptem, ale mogą też sprawiać, że ruch będzie sztywniejszy.
shiftnumberNie5min 1 / max 10 / step 0.1-Tylko dla ścieżki image-plus-audio. Prawidłowe wartości to 1 do 10. Zmienia odczucie przesunięcia czasowego generowania, więc najbezpieczniej zacząć blisko wartości domyślnej.
enable_safety_checkerselectNietrue-true, falseTylko dla ścieżki image-plus-audio. Włącz, aby uruchomić kontrole bezpieczeństwa przed generowaniem, albo wyłącz, gdy potrzebujesz mniej filtrowania i akceptujesz ten kompromis.

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 do 2 zasobów. Tryb tekstowy nie wymaga żadnych, image-to-video używa 1 obrazu, a tryb image-plus-audio używa 1 obrazu i 1 klipu audio.

Maks. plików

2

Akceptowane rodzaje plików

image, audio

Token czasu trwania

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

kindMaks. rozmiarTypy MIME
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma

Żądanie minimalne

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Opcjonalne wykluczenia albo tryby błędu do uniknięcia.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Opcjonalne wykluczenia albo tryby błędu do uniknięcia.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true",
    "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_2_a14b_turbo_example",
  "status": "queued",
  "model": "wan-2-2-a14b-turbo",
  "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.