Initialize Video for Editing

Initialize video elements via Kling init-selection endpoint in CometAPI to start multimodal editing with selectable regions and timestamps.

POST /kling/v1/videos/multi-elements/init-selection

cURL

video

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-elements/init-selection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_id": "784912347344945152",
  "task_id": "784912347277836288"
}
'

200

{
  "code": 123,
  "message": "<string>",
  "data": {
    "session_id": "<string>"
  }
}

Use this endpoint to open a video-editing session and obtain the session_id required by all later multimodal editing steps.

Choose one input path

• Kling-generated video: send video_id plus the parent task_id
• External or already-hosted video: send video_url
• Do not send both input paths at the same time

Workflow role

1. Initialize the session

   Submit the source clip and save the returned session_id.

2. Mark selection points

   Continue with Add Video Selection to define the region you want to edit.

3. Submit the final edit task

   After selection is ready, continue with Create Task.

For the complete parameter reference, see the Kling API documentation.

Authorizations

Authorization · string · header · required

Bearer token authentication. Use your CometAPI key.

Body

application/json

Option 1

Option 2

video_id · string · default: 784912347344945152 · required

The video ID generated by Kling; choose either this or video_url, they cannot be passed simultaneously. Select the video to be edited from historical works using the video ID. Only supports video works generated within the last 30 days; only supports videos with a duration of ≥2 seconds and ≤5.5 seconds, or ≥7 seconds and ≤10.5 seconds. Related to the video_url parameter, they cannot both be empty or both have values.

task_id · string · default: 784912347277836288 · required

When passing video_id, the task_id from when the video was generated must also be passed.

video_url · string · default: https://v15-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/stream_lake_m2v_img2video_multi_id_v16_std/aa12ae6e-450d-4f36-b2d0-74376b313268_raw_video.mp4?x-kcdn-pid=112372

The URL to get the video. When uploading, pass the video download link. When editing a selection, pass the video URL returned by the interface.

Only supports MP4 and MOV formats. Only supports videos with a duration of ≥2 seconds and ≤5.5 seconds, or ≥7 seconds and ≤10.5 seconds. The width and height dimensions of the video must be between 720px (inclusive) and 2160px (inclusive). Only supports uploading videos at 24, 30, or 60 fps. Related to the video_id parameter, they cannot both be empty or both have values.

Response

200 - application/json

Session initialized.

code · integer · required

message · string · required

data · object · required

Show child attributes