Opprett en Kling Motion Control-oppgave

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

Bruk dette endepunktet til å opprette en Motion Control-oppgave fra et karakterbilde og en referansevideo.

Denne siden beskriver den kompatible Motion Control-ruten. Kling Video 3.0 Motion Control bruker en separat API-kontrakt.

Nødvendige medier

image_url aksepterer en offentlig URL eller en rå Base64-streng.

Bruk et JPG-, JPEG- eller PNG-bilde som er på maksimalt 10 MB.
Angi hver bildedimensjon til mellom 300 og 65 536 piksler.
Bruk et størrelsesforhold mellom 1:2,5 og 2,5:1.
Send Base64 som den rå kodede strengen uten et data:image/...;base64, prefiks.
Vis én karakter uten hindringer, med kroppsutsnitt som samsvarer med bevegelses referansen.

video_url aksepterer en offentlig MP4- eller MOV-URL.

Bruk en video som er på maksimalt 100 MB.
Angi den korte siden til minst 340 piksler.
Angi den lange siden til maksimalt 3850 piksler.
Bruk en sammenhengende opptak med én synlig karakter.
Unngå klipp, kameraendringer og svært raske bevegelser.

Følg varighetsgrensene, og kontroller den nestede endelige task_status. En ytre HTTP 200 eller responsen code: 0 bekrefter spørringsresponsen, ikke et vellykket genereringsresultat.

Angi orienteringsverdien

character_orientation er obligatorisk og godtar image eller video.

Verdi	Referansevideoens varighet
`image`	3–10 sekunder
`video`	3–30 sekunder

Hvis du bruker element_list, angir du character_orientation til video.

Velg modell og modus

Den kompatible ruten godtar kling-v2-6 og kling-v3. Begge modellverdiene godtar begge modusverdiene:

Modell	`std`	`pro`
`kling-v2-6`	Godkjent	Godkjent
`kling-v3`	Godkjent	Godkjent

Hvis du utelater model_name, bruker forespørselen kling-v2-6. Hvis du utelater mode, bruker forespørselen std. Verdien kling-v3 beholder den kompatible forespørselsstrukturen som beskrives på denne siden; den velger ikke den separate kontrakten for Kling 3.0 med baneversjon . Den kompatible kontrakten garanterer ikke en fast utdataoppløsning. Kontroller hver returnerte video hvis applikasjonen krever bestemte dimensjoner. keep_original_sound aksepterer yes eller no. Hvis du utelater dette feltet, bruker forespørselen yes.

Oppgaveflyt

Send Motion Control-forespørselen

Send kildebildet, referansevideoen og orienteringsverdien. Velg en modell, modus og lydverdi, eller bruk de dokumenterte standardverdiene. Lagre den returnerte task_id.

Spørr oppgaven

Bruk Hent en Kling-oppgave med den returnerte task_id. Fortsett til statusen er succeed eller failed.

Lagre resultatet

Last ned og lagre resultatet raskt. Klings kompatible API- dokumentasjon oppgir at genererte videoer slettes etter 30 dager. Ikke stol på at den returnerte URL-en forblir tilgjengelig i hele 30-dagersperioden.

Valgfrie felt

Felt	Struktur	Begrensning
`prompt`	Streng, maksimalt 2500 tegn	Valgfritt tekstfelt i den kompatible forespørselsstrukturen.
`callback_url`	URI-streng eller tom streng	Utelat feltet eller bruk en tom streng når ingen callback-URI er konfigurert.
`external_task_id`	Streng som er unik for kontoen din	Kobler oppgaven til applikasjonen din. Den erstatter ikke den returnerte `task_id` for CometAPI-spørringer.
`element_list`	Array med maksimalt ett `{"element_id": 123}`-objekt	Kombiner dette feltet bare med `character_orientation: "video"`.
`watermark_info`	`{"enabled": boolean}`	Den kompatible vannmerkestrukturen inneholder bare den boolske verdien `enabled`.

Callback-struktur

Legacy-callback-skjemaet har følgende struktur:

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

Callback-statusen kan være submitted, processing, succeed eller failed. Endelige resultatfelt finnes bare når de returneres for den endelige tilstanden.

Resultatfelt

Felt	Type	Beskrivelse
`task_result.videos[].id`	Streng	ID for generert video.
`task_result.videos[].url`	URI-streng	Leverings-URL for generert video.
`task_result.videos[].watermark_url`	URI-streng	Leverings-URL for vannmerket video når oppgaven returnerer en.
`task_result.videos[].duration`	Streng	Varighet for generert video i sekunder.
`final_unit_deduction`	Streng	Endelig verdi for enhetsfradrag returnert med oppgaven.
`final_balance_deduction`	`{"quota": string, "list_price": string}`	Endelige verdier for balansefradrag returnert med oppgaven.

Oppgavestatusen er submitted, processing, succeed eller failed.

Se Kling Motion Control API-referansen og Kling-callback-protokollen for API-detaljer.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

application/json

image_url

string

påkrevd

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>

påkrevd

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>

påkrevd

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.

Tilgjengelige alternativer:

image,

video

model_name

enum<string>

standard: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.

Tilgjengelige alternativer:

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>

standard:yes

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

Tilgjengelige alternativer:

yes,

no

mode

enum<string>

standard:std

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

Tilgjengelige alternativer:

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

Svar

200 - application/json

Task accepted.

code

integer

påkrevd

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

message

string

påkrevd

Response message.

data

object

påkrevd

Show child attributes

Sist endret 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
  }
}

Innholdsmoderering

API-nøkler

Opprett en Kling Motion Control-oppgave

Nødvendige medier

Angi orienteringsverdien

Velg modell og modus

Oppgaveflyt

Valgfrie felt

Callback-struktur

Resultatfelt

Autorisasjoner

Kropp

Svar

​Nødvendige medier

​Angi orienteringsverdien

​Velg modell og modus

​Oppgaveflyt

​Valgfrie felt

​Callback-struktur

​Resultatfelt

Autorisasjoner

Kropp

Svar

Nødvendige medier

Angi orienteringsverdien

Velg modell og modus

Oppgaveflyt

Valgfrie felt

Callback-struktur

Resultatfelt