Omni 视频（Legacy）

Omni video

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "duration": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "image_list": [
    {
      "image": "<string>",
      "image_url": "<string>",
      "type": "<string>"
    }
  ],
  "mode": "<string>",
  "model_name": "<string>",
  "multi_prompt": [
    {
      "duration": "<string>",
      "index": 123,
      "prompt": "<string>"
    }
  ],
  "multi_shot": true,
  "prompt": "<string>",
  "shot_type": "<string>",
  "sound": "<string>",
  "video_list": [
    {
      "keep_original_sound": "<string>",
      "refer_type": "<string>",
      "video_url": "<string>"
    }
  ],
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/videos/omni-video"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "duration": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "image_list": [
        {
            "image": "<string>",
            "image_url": "<string>",
            "type": "<string>"
        }
    ],
    "mode": "<string>",
    "model_name": "<string>",
    "multi_prompt": [
        {
            "duration": "<string>",
            "index": 123,
            "prompt": "<string>"
        }
    ],
    "multi_shot": True,
    "prompt": "<string>",
    "shot_type": "<string>",
    "sound": "<string>",
    "video_list": [
        {
            "keep_original_sound": "<string>",
            "refer_type": "<string>",
            "video_url": "<string>"
        }
    ],
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    duration: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    image_list: [{image: '<string>', image_url: '<string>', type: '<string>'}],
    mode: '<string>',
    model_name: '<string>',
    multi_prompt: [{duration: '<string>', index: 123, prompt: '<string>'}],
    multi_shot: true,
    prompt: '<string>',
    shot_type: '<string>',
    sound: '<string>',
    video_list: [
      {keep_original_sound: '<string>', refer_type: '<string>', video_url: '<string>'}
    ],
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/videos/omni-video', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/videos/omni-video",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'duration' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'image_list' => [
        [
                'image' => '<string>',
                'image_url' => '<string>',
                'type' => '<string>'
        ]
    ],
    'mode' => '<string>',
    'model_name' => '<string>',
    'multi_prompt' => [
        [
                'duration' => '<string>',
                'index' => 123,
                'prompt' => '<string>'
        ]
    ],
    'multi_shot' => true,
    'prompt' => '<string>',
    'shot_type' => '<string>',
    'sound' => '<string>',
    'video_list' => [
        [
                'keep_original_sound' => '<string>',
                'refer_type' => '<string>',
                'video_url' => '<string>'
        ]
    ],
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/videos/omni-video"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/videos/omni-video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/videos/omni-video")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "videos": [
        {
          "duration": "<string>",
          "id": "<string>",
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "videos": [
          {
            "duration": "<string>",
            "id": "<string>",
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

POST

kling

videos

omni-video

Omni video

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "duration": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "image_list": [
    {
      "image": "<string>",
      "image_url": "<string>",
      "type": "<string>"
    }
  ],
  "mode": "<string>",
  "model_name": "<string>",
  "multi_prompt": [
    {
      "duration": "<string>",
      "index": 123,
      "prompt": "<string>"
    }
  ],
  "multi_shot": true,
  "prompt": "<string>",
  "shot_type": "<string>",
  "sound": "<string>",
  "video_list": [
    {
      "keep_original_sound": "<string>",
      "refer_type": "<string>",
      "video_url": "<string>"
    }
  ],
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/videos/omni-video"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "duration": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "image_list": [
        {
            "image": "<string>",
            "image_url": "<string>",
            "type": "<string>"
        }
    ],
    "mode": "<string>",
    "model_name": "<string>",
    "multi_prompt": [
        {
            "duration": "<string>",
            "index": 123,
            "prompt": "<string>"
        }
    ],
    "multi_shot": True,
    "prompt": "<string>",
    "shot_type": "<string>",
    "sound": "<string>",
    "video_list": [
        {
            "keep_original_sound": "<string>",
            "refer_type": "<string>",
            "video_url": "<string>"
        }
    ],
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    duration: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    image_list: [{image: '<string>', image_url: '<string>', type: '<string>'}],
    mode: '<string>',
    model_name: '<string>',
    multi_prompt: [{duration: '<string>', index: 123, prompt: '<string>'}],
    multi_shot: true,
    prompt: '<string>',
    shot_type: '<string>',
    sound: '<string>',
    video_list: [
      {keep_original_sound: '<string>', refer_type: '<string>', video_url: '<string>'}
    ],
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/videos/omni-video', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/videos/omni-video",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'duration' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'image_list' => [
        [
                'image' => '<string>',
                'image_url' => '<string>',
                'type' => '<string>'
        ]
    ],
    'mode' => '<string>',
    'model_name' => '<string>',
    'multi_prompt' => [
        [
                'duration' => '<string>',
                'index' => 123,
                'prompt' => '<string>'
        ]
    ],
    'multi_shot' => true,
    'prompt' => '<string>',
    'shot_type' => '<string>',
    'sound' => '<string>',
    'video_list' => [
        [
                'keep_original_sound' => '<string>',
                'refer_type' => '<string>',
                'video_url' => '<string>'
        ]
    ],
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/videos/omni-video"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/videos/omni-video")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/videos/omni-video")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"duration\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"mode\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"multi_prompt\": [\n    {\n      \"duration\": \"<string>\",\n      \"index\": 123,\n      \"prompt\": \"<string>\"\n    }\n  ],\n  \"multi_shot\": true,\n  \"prompt\": \"<string>\",\n  \"shot_type\": \"<string>\",\n  \"sound\": \"<string>\",\n  \"video_list\": [\n    {\n      \"keep_original_sound\": \"<string>\",\n      \"refer_type\": \"<string>\",\n      \"video_url\": \"<string>\"\n    }\n  ],\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "videos": [
        {
          "duration": "<string>",
          "id": "<string>",
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "videos": [
          {
            "duration": "<string>",
            "id": "<string>",
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

本页对应官方 Legacy Omni 视频。新版 contents/settings/options 请求请使用 API 2.0。

参数	类型	说明
`model_name`	string	`kling-video-o1`（默认）或 `kling-v3-omni`
`prompt`	string	单镜头、智能分镜必填；自定义分镜可省略
`multi_shot`	boolean	默认false；3.0 Omni支持多镜头
`shot_type`	string	多镜头时必填，`customize/intelligence`
`multi_prompt`	array	自定义分镜 `[{index,prompt,duration}]`，序号从1连续递增、最多6段，每段至少1秒，总时长须等于duration
`image_list`	array	`[{image_url,type}]`；首尾帧type为 `first_frame/end_frame`
`element_list`	array	`[{element_id}]`，保留主体ID精度
`video_list`	array	`[{video_url,refer_type,keep_original_sound}]`；feature为参考、base为编辑
`sound`	string	`on/off`，原生音频支持范围按模型
`mode`	string	默认pro；3.0 Omni支持std/pro/4k，O1为std/pro
`aspect_ratio`	string	16:9、9:16、1:1；是否需要由输入组合决定
`duration`	string	默认5；3.0 Omni为3～15秒，O1为3～10秒，具体组合以官网为准
`watermark_info`	object	`{"enabled":true}` 同时生成水印结果
`callback_url`	string	公网HTTPS回调地址
`external_task_id`	string	业务ID，推荐UUID避免上游账号内冲突

图片、主体和视频可用 <<<image_1>>>、<<<element_1>>>、<<<video_1>>> 在旧版提示词中引用。参考数量与组合上限因模型和素材类型不同而变化，不把O1的限制套用到3.0 Omni。 refer_type=base 的视频编辑不支持首尾帧和多镜头，生成时长与输入视频一致。视频参考及原生音频组合限制请遵循对应官方模型页。

自定义分镜示例

curl -X POST "https://models.kapon.cloud/kling/v1/videos/omni-video" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name":"kling-v3-omni",
    "multi_shot":true,
    "shot_type":"customize",
    "multi_prompt":[
      {"index":1,"prompt":"A train enters a snowy valley","duration":"3"},
      {"index":2,"prompt":"The camera follows the train","duration":"3"}
    ],
    "duration":"6",
    "mode":"pro",
    "aspect_ratio":"16:9"
  }'

创建返回 data.task_id 和平台 platform_id。使用 /kling/v1/videos/omni-video/{id} 查询；成功状态为 succeed，视频结果位于 task_result.videos。完整说明见 Legacy 任务查询。

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

aspect_ratio

string

画面纵横比

callback_url

string

回调通知地址

duration

string

视频时长

element_list

object[]

主体参考列表

Show child attributes

external_task_id

string

自定义任务ID

image_list

object[]

参考图列表

Show child attributes

mode

string

生成模式：std, pro

model_name

string

模型名称，默认kling-video-o1

multi_prompt

object[]

Show child attributes

multi_shot

boolean

prompt

string

正向文本提示词，必须

shot_type

string

sound

string

是否生成声音：on/off

参考视频列表

Show child attributes

watermark_info

object

水印信息

Show child attributes

Response

200 - application/json

code

integer

错误码

data

object

单个任务数据

Show child attributes

data_list

object[]

任务列表数据（用于列表查询）

Show child attributes

message

string

错误信息

request_id

string

请求ID

概述

API 2.0

Legacy 视频生成

图像生成

视频编辑

任务管理

自定义分镜示例

Authorizations

Body

Response

​自定义分镜示例

Authorizations

Body

Response

自定义分镜示例