Rivya AI-docs
Model-API-pagina's

Wan 2.7 Video API-integratie

Gebruik Wan 2.7 Video via Rivya Public API v1 met model-id wan-2-7-video, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIVideo
API-model-id

wan-2-7-video

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

80

Mogelijkheid

Video

Facturering

FIXED

Promptlimiet

5000 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

KeyTypeVereistStandaardBeschrijving
modelstringJawan-2-7-videoGebruik de API-model-id wan-2-7-video.
promptstringJa-Maximaal 5000 tekens voor dit model.
paramsobjectNee-Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_idstringNee-Optionele client-side id voor requesttracing in je systeem.

Modelparameters

KeyTypeVereistStandaardBereikOptiesBeschrijving
resolutionselectNee720p-720p, 1080pResolutie
durationselectNee5-5, 10, 15Tekst- en afbeeldingsruns kunnen 5, 10 of 15 seconden gebruiken. Videobewerking stopt momenteel bij 10 seconden, en Rivya normaliseert langere selecties automatisch in die modus.
aspect_ratioselectNee16:9-16:9, 9:16, 1:1, 4:3, 3:4Tekst-naar-video- en videobewerkingsruns gebruiken dit direct. Afbeelding-naar-video volgt momenteel de geometrie van het geuploade frame in plaats van een aparte schakelaar voor beeldverhouding te tonen.
negative_prompttextNee---Negatieve prompt
prompt_extendselectNeetrue-true, falseBepaalt of het model je prompt herschrijft voor generatie. Laat dit aan voor gemak, of zet het uit wanneer je al een zeer precieze prompt hebt.
watermarkselectNeefalse-false, trueWatermerk
audio_settingselectNeeauto-auto, originBepaalt hoe audio wordt behandeld in het videobewerkingspad. Auto laat het model beslissen, terwijl Origineel behouden probeert de audio van de bronvideo te bewaren.
seednumberNee-min 0 / max 2147483647-Laat dit leeg voor elke keer een nieuw willekeurig resultaat. Door hetzelfde gehele getal opnieuw te gebruiken, wordt het makkelijker om een eerder resultaat te reproduceren of fijn af te stemmen. Het blijft alleen dichterbij wanneer de prompt en andere belangrijke instellingen ook vergelijkbaar blijven, en het is geen gegarandeerde 1-op-1 match.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Referentiemedia: Upload maximaal 2 assets. Gebruik maximaal 2 afbeeldingen voor afbeelding-naar-video, of 1 video plus 1 optionele afbeelding voor videobewerking.

Max. bestanden

2

Geaccepteerde bestandstypen

image, video

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kindMax. grootteMIME-types
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/mp4, video/quicktime

Minimale request

{
  "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": "Optionele uitsluitingen of faalmodi om te vermijden.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Request met referentiebestand

{
  "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": "Optionele uitsluitingen of faalmodi om te vermijden.",
    "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-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

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

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.