Een Kling Motion Control-taak maken

POST

kling

videos

motion-control

curl https://api.cometapi.com/kling/v1/videos/motion-control \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v3",
    "image_url": "https://your-image-host.example.com/character.png",
    "video_url": "https://your-video-host.example.com/reference-motion.mp4",
    "prompt": "Studio scene.",
    "keep_original_sound": "no",
    "character_orientation": "video",
    "mode": "std"
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1785398400000,
    "updated_at": 1785398400000
  }
}

Gebruik dit endpoint om een Motion Control-taak te maken op basis van een personageafbeelding en een referentievideo.

Deze pagina beschrijft de compatibele Motion Control-route. Kling Video 3.0 Motion Control gebruikt een afzonderlijk API-contract.

Vereiste media

image_url accepteert een openbare URL of een onbewerkte Base64-tekenreeks.

Gebruik een JPG-, JPEG- of PNG-afbeelding van maximaal 10 MB.
Zorg dat elke afbeeldingsdimensie tussen 300 en 65.536 pixels ligt.
Gebruik een beeldverhouding van 1:2.5 tot en met 2.5:1.
Verzend Base64 als de onbewerkte gecodeerde tekenreeks zonder een data:image/...;base64, voorvoegsel.
Toon één onbelemmerd zichtbaar personage met een kadrering die overeenkomt met de bewegingsreferentie.

video_url accepteert een openbare MP4- of MOV-URL.

Gebruik een video van maximaal 100 MB.
Zorg dat de korte zijde minstens 340 pixels is.
Zorg dat de lange zijde niet meer dan 3850 pixels is.
Gebruik een doorlopende opname met één zichtbaar personage.
Vermijd cuts, camerawijzigingen en buitengewoon snelle bewegingen.

Volg de duurbeperkingen en controleer de geneste terminale task_status. Een HTTP 200-status op het hoogste niveau of de respons code: 0 bevestigt alleen het queryantwoord, niet het succesvolle generatieresultaat.

Stel de oriëntatiewaarde in

character_orientation is verplicht en accepteert image of video.

Waarde	Duur van referentievideo
`image`	3–10 seconden
`video`	3–30 seconden

Als u element_list gebruikt, stelt u character_orientation in op video.

Kies het model en de modus

De compatibele route accepteert kling-v2-6 en kling-v3. Beide modelwaarden accepteren beide moduswaarden:

Model	`std`	`pro`
`kling-v2-6`	Geaccepteerd	Geaccepteerd
`kling-v3`	Geaccepteerd	Geaccepteerd

Als u model_name weglaat, gebruikt de aanvraag kling-v2-6. Als u mode weglaat, gebruikt de aanvraag std. De waarde kling-v3 behoudt de vorm van de compatibele aanvraag die op deze pagina wordt beschreven; deze selecteert niet het afzonderlijke Kling 3.0-contract voor de padversie. Het compatibele contract garandeert geen vaste uitvoerresolutie. Controleer elke geretourneerde video als uw toepassing specifieke afmetingen vereist. keep_original_sound accepteert yes of no. Als u dit veld weglaat, gebruikt de aanvraag yes.

Taakverloop

Dien het Motion Control-verzoek in

Verzend de bronafbeelding, referentievideo en oriëntatiewaarde. Selecteer een model, modus en geluidswaarde of gebruik de gedocumenteerde standaardwaarden. Sla de geretourneerde task_id op.

Controleer de taakstatus

Gebruik het endpoint Kling-taak ophalen met de geretourneerde task_id. Ga door totdat de status succeed of failed is.

Sla het resultaat op

Download en sla het resultaat meteen op. Volgens de compatibele API-documentatie van Kling worden gegenereerde video’s na 30 dagen verwijderd. Vertrouw er niet op dat de geretourneerde URL gedurende de volledige 30 dagen toegankelijk blijft.

Optionele velden

Veld	Structuur	Beperking
`prompt`	Tekenreeks, maximaal 2500 tekens	Optioneel tekstveld in de compatibele aanvraagstructuur.
`callback_url`	URI-tekenreeks of lege tekenreeks	Laat het veld weg of gebruik een lege tekenreeks wanneer geen callback-URI is geconfigureerd.
`external_task_id`	Tekenreeks die uniek is voor uw account	Koppelt de taak aan uw toepassing. Deze vervangt niet de geretourneerde `task_id` voor CometAPI-query’s.
`element_list`	Array met maximaal één `{"element_id": 123}` object	Combineer dit veld alleen met `character_orientation: "video"`.
`watermark_info`	`{"enabled": boolean}`	De compatibele watermerkstructuur bevat alleen de Booleaanse waarde `enabled`.

Callbackstructuur

Het Legacy-callbackschema heeft de volgende structuur:

{
  "task_id": "<task_id>",
  "task_status": "succeed",
  "task_status_msg": "",
  "created_at": 1785398400000,
  "updated_at": 1785398460000,
  "final_unit_deduction": "<value>",
  "final_balance_deduction": {
    "quota": "<value>",
    "list_price": "<value>"
  },
  "task_info": {
    "external_task_id": "<your_unique_id>"
  },
  "task_result": {
    "videos": [
      {
        "id": "<video_id>",
        "url": "https://media.example.com/<file_id>.mp4",
        "duration": "6.4"
      }
    ]
  }
}

De callbackstatus kan submitted, processing, succeed of failed zijn. Eindresultaatvelden zijn alleen aanwezig wanneer ze voor de eindstatus worden geretourneerd.

Resultaatvelden

Veld	Type	Beschrijving
`task_result.videos[].id`	Tekenreeks	ID van de gegenereerde video.
`task_result.videos[].url`	URI-tekenreeks	Leverings-URL van de gegenereerde video.
`task_result.videos[].watermark_url`	URI-tekenreeks	Leverings-URL van de video met watermerk wanneer de taak er een retourneert.
`task_result.videos[].duration`	Tekenreeks	Duur van de gegenereerde video in seconden.
`final_unit_deduction`	Tekenreeks	Definitieve aftrekwaarde voor eenheden die met de taak wordt geretourneerd.
`final_balance_deduction`	`{"quota": string, "list_price": string}`	Definitieve waarden voor saldoaftrek die met de taak worden geretourneerd.

De taakstatus is submitted, processing, succeed of failed.

Zie de Kling Motion Control API-referentie en Kling-callbackprotocol voor API-details.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

application/json

image_url

string

vereist

Character image as a public URL or a raw Base64 string. Send raw Base64 without a data:image/...;base64, prefix; data-URI input is outside the compatible contract. Supported formats are JPG, JPEG, and PNG. The image must be 10 MB or smaller. Its width and height must each be from 300 through 65,536 pixels, and its aspect ratio must be between 1:2.5 and 2.5:1.

video_url

string<uri>

vereist

Public reference motion video URL. Use an MP4 or MOV file that is 100 MB or smaller. The short edge must be at least 340 pixels, and the long edge must not exceed 3850 pixels. The video must be at least 3 seconds long. The maximum duration depends on character_orientation.

character_orientation

enum<string>

vereist

Required compatible string enum. With image, the reference video can be 3 to 10 seconds long. With video, the reference video can be 3 to 30 seconds long.

Beschikbare opties:

image,

video

model_name

enum<string>

standaard:kling-v2-6

Model ID for this compatible Motion Control request. Omit this field to use kling-v2-6. The kling-v3 value keeps this compatible request shape; it does not select the separate Kling 3.0 path-version contract.

Beschikbare opties:

kling-v2-6,

kling-v3

prompt

string

Optional text field in the compatible request structure. Maximum 2500 characters.

Maximum string length: 2500

keep_original_sound

enum<string>

standaard:yes

Compatible string enum. Accepted values are yes and no. Omitted requests use yes.

Beschikbare opties:

yes,

no

mode

enum<string>

standaard:std

Both compatible models accept std and pro. Omitted requests use std.

Beschikbare opties:

std,

pro

callback_url

Optional callback field in the compatible structure. Provide a URI, or omit the field or send an empty string when no callback URI is configured.

external_task_id

string

Optional ID for correlation in your application. The value must be unique for your account. Store the returned task_id for CometAPI status queries.

element_list

object[]

Optional compatible Element structure. Provide at most one object, and combine this field only with character_orientation: video.

Maximum array length: 1

Show child attributes

watermark_info

object

Optional compatible watermark structure.

Show child attributes

Respons

200 - application/json

Task accepted.

code

integer

vereist

Response code. A value of 0 indicates that the request was accepted.

message

string

vereist

Response message.

data

object

vereist

Show child attributes

Laatst gewijzigd op 31 juli 2026

curl https://api.cometapi.com/kling/v1/videos/motion-control \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v3",
    "image_url": "https://your-image-host.example.com/character.png",
    "video_url": "https://your-video-host.example.com/reference-motion.mp4",
    "prompt": "Studio scene.",
    "keep_original_sound": "no",
    "character_orientation": "video",
    "mode": "std"
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1785398400000,
    "updated_at": 1785398400000
  }
}

Contentmoderatie

API-sleutels

Vereiste media

Stel de oriëntatiewaarde in

Kies het model en de modus

Taakverloop

Optionele velden

Callbackstructuur

Resultaatvelden

Autorisaties

Body

Respons

​Vereiste media

​Stel de oriëntatiewaarde in

​Kies het model en de modus

​Taakverloop

​Optionele velden

​Callbackstructuur

​Resultaatvelden

Autorisaties

Body

Respons

Vereiste media

Stel de oriëntatiewaarde in

Kies het model en de modus

Taakverloop

Optionele velden

Callbackstructuur

Resultaatvelden