Rivya AI-dokumentasjon
Modell-API-sider

Wan 2.5 Video API-integrasjon

Bruk Wan 2.5 Video via Rivya Public API v1 med modell-ID wan-2-5-video, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

Tilgjengelig via APITekst eller URL er klar; referansemoduser bruker Files APIVideo
API-modell-ID

wan-2-5-video

Inndata

text, file

Files API

Kreves for referansemoduser

Basiskreditter

60

Egenskap

Video

Fakturering

FIXED

Promptgrense

5000 tegn

Forespørselskontrakt

Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.

NøkkelTypePåkrevdStandardBeskrivelse
modelstringJawan-2-5-videoBruk API-modell-ID-en wan-2-5-video.
promptstringJa-Maksimalt 5000 tegn for denne modellen.
paramsobjectNei-Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler.
client_request_idstringNei-Valgfri klient-ID for sporing av forespørsler i systemet ditt.

Modellparametere

NøkkelTypePåkrevdStandardOmrådeAlternativerBeskrivelse
resolutionselectNei720p-720p, 1080pOppløsning
durationselectNei5-5, 10Varighet
aspect_ratioselectNei16:9-16:9, 9:16, 1:1Sideforhold
enable_prompt_expansionselectNeifalse-false, trueNår dette er slått på, lar Rivya oppstrømsmodellen utvide prompten din med ekstra detaljer samtidig som den opprinnelige intensjonen bevares. Slå det av når du allerede har en stramt skrevet prompt.
seednumberNei-min 0 / max 2147483647-La det stå tomt for et nytt tilfeldig resultat hver gang. Å bruke samme heltall på nytt gjør det enklere å gjenskape eller finjustere et tidligere resultat. Det holder seg bare nærmere når prompten og andre viktige innstillinger også forblir like, og det er ikke en garantert 1:1-match.
negative_prompttextNei---Negativ prompt
nsfw_checkerselectNeifalse-false, trueNSFW-sjekk

Opplastingspolicy

Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.

Referanseregel

Referansebilde: Last opp opptil 1 bildefil for bilde-til-video-modus.

Maks filer

1

Godtatte filtyper

image

Varighetstoken

Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.

kindMaks størrelseMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal forespørsel

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Valgfrie ekskluderinger eller feilmoduser å unngå.",
    "nsfw_checker": "false"
  }
}

Referansefilforespørsel

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Valgfrie ekskluderinger eller feilmoduser å unngå.",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Opprettelsessvar

Create-endepunktet returnerer en offentlig oppgave-ID. Poll statusendepunktet til oppgaven lykkes eller mislykkes.

{
  "id": "task_wan_2_5_video_example",
  "status": "queued",
  "model": "wan-2-5-video",
  "reserved_credits": 60,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.