Rivya AI-dokumentasjon
Modell-API-sider

Kling V2.5 Turbo Pro API-integrasjon

Bruk Kling V2.5 Turbo Pro via Rivya Public API v1 med modell-ID kling-v2-5-turbo-pro, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

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

kling-v2-5-turbo-pro

Inndata

text, file

Files API

Kreves for referansemoduser

Basiskreditter

42

Egenskap

Video

Fakturering

FIXED

Promptgrense

2500 tegn

Forespørselskontrakt

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

NøkkelTypePåkrevdStandardBeskrivelse
modelstringJakling-v2-5-turbo-proBruk API-modell-ID-en kling-v2-5-turbo-pro.
promptstringJa-Maksimalt 2500 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
durationselectNei5-5, 10Varighet
aspect_ratioselectNei16:9-16:9, 9:16, 1:1Sideforhold
negative_prompttextNei---Negativ prompt
cfg_scalenumberNei0.5min 0 / max 1-Kontrollerer hvor tett resultatet følger prompten din. Høyere verdier holder seg vanligvis nærmere prompten, men kan også gjøre bevegelse eller komposisjon stivere.

Opplastingspolicy

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

Referanseregel

Referansebilder: Last eventuelt opp opptil 2 bilder for å bytte til bilde-til-video-modus; det andre bildet mappes til halerammen.

Maks filer

2

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": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beskriv hva videoen bør unngå",
    "cfg_scale": 0.5
  }
}

Referansefilforespørsel

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beskriv hva videoen bør unngå",
    "cfg_scale": 0.5,
    "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_kling_v2_5_turbo_pro_example",
  "status": "queued",
  "model": "kling-v2-5-turbo-pro",
  "reserved_credits": 42,
  "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.