Rivya AI-dokumentasjon
Modell-API-sider

Kling V2.1 Pro API-integrasjon

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

Tilgjengelig via APIKlarstatusVideo
API-modell-ID

kling-v2-1-pro

Inndata

file

Files API

Kreves for referansemoduser

Basiskreditter

per_video · 5s=50 · 10s=100 · ⌈total⌉

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
modelstringJakling-v2-1-proBruk API-modell-ID-en kling-v2-1-pro.
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
durationselectNei5-5, 10Varighet
negative_prompttextNei---Negativ prompt
cfg_scalenumberNei0.5min 0 / max 1 / step 0.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: Bildemodus godtar opptil 2 bildefiler, og det andre bildet mappes til halerammen. JPEG/PNG ≤ 10 MB.

Maks antall 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

Minimal forespørsel

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Beskriv hva videoen bør unngå",
    "cfg_scale": 0.5
  }
}

Referansefilforespørsel

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "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

Opprettingsendepunktet returnerer en offentlig oppgave-ID. Hent status fra statusendepunktet til oppgaven lykkes eller mislykkes.

{
  "id": "task_kling_v2_1_pro_example",
  "status": "queued",
  "model": "kling-v2-1-pro",
  "reserved_credits": 50,
  "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
}

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.