Rivya AI-dokumentation
Modellsidor för API

Wan 2.5 Video API-integration

Använd Wan 2.5 Video via Rivyas publika API v1 med modell-ID wan-2-5-video, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIVideo
API-modell-ID

wan-2-5-video

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

60

Förmåga

Video

Fakturering

FIXED

Promptgräns

5000 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

NyckelTypObligatorisktStandardBeskrivning
modelstringJawan-2-5-videoAnvänd API-modell-ID:t wan-2-5-video.
promptstringJa-Högst 5000 tecken för den här modellen.
paramsobjectNej-Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_idstringNej-Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

NyckelTypObligatorisktStandardIntervallAlternativBeskrivning
resolutionselectNej720p-720p, 1080pUpplösning
durationselectNej5-5, 10Varaktighet
aspect_ratioselectNej16:9-16:9, 9:16, 1:1Bildförhållande
enable_prompt_expansionselectNejfalse-false, trueNär detta är aktiverat låter Rivya uppströmsmodellen utöka din prompt med extra detaljer samtidigt som den ursprungliga avsikten bevaras. Stäng av det när du redan har en strikt skriven prompt.
seednumberNej-min 0 / max 2147483647-Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte.
negative_prompttextNej---Negativ prompt
nsfw_checkerselectNejfalse-false, trueNSFW-kontroll

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbild: Ladda upp upp till 1 bildfil för bild-till-video-läge.

Max filer

1

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kindMax storlekMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal begäran

{
  "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": "Valfria uteslutningar eller feltyper att undvika.",
    "nsfw_checker": "false"
  }
}

Begäran med referensfil

{
  "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": "Valfria uteslutningar eller feltyper att undvika.",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.