Rivya AI -dokumentaatio
Mallien API-sivut

Wan 2.7 Video API -integraatio

Käytä mallia Wan 2.7 Video Rivya Public API v1:n kautta malli-ID:llä wan-2-7-video; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTeksti tai URL valmis; referenssimoodit käyttävät Files API:aVideo
API-malli-ID

wan-2-7-video

Syötteet

text, file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

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

Kyvykkyys

Video

Laskutus

FIXED

Prompt-raja

5000 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

AvainTyyppiPakollinenOletusKuvaus
modelstringKylläwan-2-7-videoKäytä wan-2-7-video-arvoa API-malli-ID:nä.
promptstringKyllä-Enintään 5000 merkkiä tälle mallille.
paramsobjectEi-Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_idstringEi-Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

AvainTyyppiPakollinenOletusAlueVaihtoehdotKuvaus
resolutionselectEi720p-720p, 1080pResoluutio
durationnumberEi5min 0 / max 15-text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s
aspect_ratioselectEi16:9-16:9, 9:16, 1:1, 4:3, 3:4Text-to-video- ja video-editing-ajot käyttävät tätä suoraan. Image-to-video seuraa tällä hetkellä ladatun kehyksen geometriaa erillisen kuvasuhdekytkimen sijaan.
negative_prompttextEi---prompt ≤ 5000; negative_prompt ≤ 500
prompt_extendselectEitrue-true, falseMäärittää, kirjoittaako malli promptisi uudelleen ennen generointia. Pidä se päällä mukavuuden vuoksi tai poista se käytöstä, kun promptisi on jo hyvin tarkka.
watermarkselectEifalse-false, trueVesileima
audio_settingselectEiauto-auto, originMäärittää, miten ääntä käsitellään video-edit-polussa. Auto antaa mallin päättää, kun taas Keep original yrittää säilyttää lähdevideon äänen.
seednumberEi-min 0 / max 2147483647-Jätä tyhjäksi, jos haluat joka kerta uuden satunnaisen tuloksen. Saman kokonaisluvun käyttäminen uudelleen helpottaa aiemman tuloksen toistamista tai hienosäätöä. Tulos pysyy lähempänä vain silloin, kun kehote ja muut keskeiset asetukset ovat myös samankaltaisia, eikä se takaa täsmälleen samaa lopputulosta.

Latauskäytäntö

Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.

Referenssisääntö

Viitemedia: Viitemedia: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

Enimmäistiedostot

2

Hyväksytyt tiedostotyypit

image, video

Duration token

Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.

kindEnimmäiskokoMIME-tyypit
image30 MBimage/jpeg, image/png, image/webp
video30 MBvideo/mp4, video/quicktime

Minimipyyntö

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

Referenssitiedostopyyntö

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

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

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

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Jotkin moodit vaativat Files API -referenssilatauksia.