Brug Kling V2.5 Turbo Pro via Rivya Public API v1 med model-id kling-v2-5-turbo-pro, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIVideo

API-model-id

kling-v2-5-turbo-pro

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

Funktion

Video

Fakturering

FIXED

Promptgrænse

2500 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	kling-v2-5-turbo-pro	Brug API-model-id'et kling-v2-5-turbo-pro.
prompt	string	Ja	-	Maksimalt 2500 tegn for denne model.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
duration	select	Nej	5	-	5, 10	Varighed
aspect_ratio	select	Nej	16:9	-	16:9, 9:16, 1:1	Billedformat
negative_prompt	text	Nej	-	-	-	Negativ prompt
cfg_scale	number	Nej	0.5	min 0 / max 1	-	Styrer, hvor tæt resultatet følger din prompt. Højere værdier holder sig normalt tættere på prompten, men kan også få bevægelse eller komposition til at føles stivere.

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencebilleder: Upload eventuelt op til 2 billeder for at skifte til billede-til-video-tilstand; det andet billede mappes til slutframen.

Maks. filer

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kind	Maks. størrelse	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal anmodning

{
  "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, hvad videoen skal undgå",
    "cfg_scale": 0.5
  }
}

Referencefilanmodning

{
  "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, hvad videoen skal undgå",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.

Kling V2.5 Turbo Pro API-integration