Gebruik Kling V2.5 Turbo Pro via Rivya Public API v1 met model-id kling-v2-5-turbo-pro, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIVideo

API-model-id

kling-v2-5-turbo-pro

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

Mogelijkheid

Video

Facturering

FIXED

Promptlimiet

2500 tekens

Requestcontract

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

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	kling-v2-5-turbo-pro	Gebruik de API-model-id kling-v2-5-turbo-pro.
prompt	string	Ja	-	Maximaal 2500 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
duration	select	Nee	5	-	5, 10	Duur
aspect_ratio	select	Nee	16:9	-	16:9, 9:16, 1:1	Beeldverhouding
negative_prompt	text	Nee	-	-	-	Negatieve prompt
cfg_scale	number	Nee	0.5	min 0 / max 1	-	Bepaalt hoe strikt het resultaat je prompt volgt. Hogere waarden blijven meestal dichter bij de prompt, maar kunnen beweging of compositie ook stijver laten aanvoelen.

Uploadbeleid

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

Referentieregel

Referentiebeelden: Upload optioneel maximaal 2 afbeeldingen om naar beeld-naar-video te schakelen; de tweede afbeelding wordt aan het tail frame gekoppeld.

Max. bestanden

Geaccepteerde bestandstypen

image

Duurtoken

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

kind	Max. grootte	MIME-types
image	10 MB	image/jpeg, image/png, image/webp

Minimale request

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beschrijf wat de video moet vermijden",
    "cfg_scale": 0.5
  }
}

Request met referentiebestand

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beschrijf wat de video moet vermijden",
    "cfg_scale": 0.5,
    "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_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
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Kling V2.5 Turbo Pro API-integratie