Gebruik Kling 3.0 motion-control via Rivya Public API v1 met model-id kling-3-0-motion-control, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APIGereedheidVideo

API-model-id

kling-3-0-motion-control

Inputs

file

Files API

Vereist voor referentiemodi

Basiscredits

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

Mogelijkheid

Video

Facturering

METERED

Promptlimiet

2500 tekens

Requestcontract

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

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	kling-3-0-motion-control	Gebruik de API-model-id kling-3-0-motion-control.
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
mode	select	Nee	720p	-	720p, 1080p	Generatiemodus
character_orientation	select	Nee	video	-	video, image	Bepaalt of de oriëntatie van het karakter dichter bij de motion video of bij het referentiebeeld moet blijven.

Uploadbeleid

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

Referentieregel

Referentiebeeld + motion video: Exact 1 beeld + 1 motion-video project houdt rollen voor identiteit en beweging duidelijk Standard (720P): 20 × geverifieerde seconden van de bewegingsvideo; Pro (1080P): 27 × seconden

Max. bestanden

Geaccepteerde bestandstypen

image, video

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
video	95 MB	video/mp4, video/quicktime

Minimale request

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video"
  }
}

Request met referentiebestand

{
  "model": "kling-3-0-motion-control",
  "params": {
    "mode": "720p",
    "character_orientation": "video",
    "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_3_0_motion_control_example",
  "status": "queued",
  "model": "kling-3-0-motion-control",
  "reserved_credits": 27,
  "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
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Kling 3.0 motion-control API-integratie