Kling
建立 Kling 進階唇形同步任務
透過 CometAPI Kling POST /kling/v1/videos/advanced-lip-sync 建立進階唇形同步影片任務，提交音訊與對應角色設定以產生同步結果。
POST
/
kling
/
v1
/
videos
/
advanced-lip-sync
cURL
curl https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
}'import os
import requests
response = requests.post(
"https://api.cometapi.com/kling/v1/videos/advanced-lip-sync",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
},
)
result = response.json()
print(result.get("code"), result.get("data", {}).get("task_id"))const response = await fetch("https://api.cometapi.com/kling/v1/videos/advanced-lip-sync", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
}),
});
const result = await response.json();
console.log(result.code, result.data?.task_id);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/kling/v1/videos/advanced-lip-sync",
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([
'session_id' => '<session_id>',
'face_choose' => [
[
'face_id' => '<face_id>',
'sound_file' => 'https://your-audio-host/speech.wav',
'sound_start_time' => '0',
'sound_end_time' => '2000',
'sound_insert_time' => '0',
'sound_volume' => 1,
'original_sound_volume' => 0
]
]
]),
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://api.cometapi.com/kling/v1/videos/advanced-lip-sync"
payload := strings.NewReader("{\n \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\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://api.cometapi.com/kling/v1/videos/advanced-lip-sync")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/kling/v1/videos/advanced-lip-sync")
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 \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}使用此端點可在你已經辨識出來源影片中的人臉後，建立進階唇形同步任務。
在你呼叫它之前
- 先從 Lip-Sync 開始，以取得
session_id和可用的face_id值 - 建立一個或多個
face_choose項目，將每張臉對應到一段音訊 - 對於先前任務產生的音訊使用
audio_id，或對於已託管的音訊檔使用sound_file - 以毫秒傳送時間欄位。例如，
sound_start_time: "0"和sound_end_time: "2000"會選取前 2 秒。 - 確保裁剪後的音訊片段至少為 2000 ms，且不得超過來源音訊的時長
- 僅在你需要 webhook 傳送或自己的追蹤 id 時設定
callback_url或external_task_id
任務流程
1
先辨識人臉
在來源影片上執行 Lip-Sync，並保留回傳的
session_id 以及目標 face_id 值。2
建立進階唇形同步任務
透過此端點提交
session_id 與 face_choose 陣列。3
追蹤產生的任務
儲存回傳的任務 id，以便進行狀態查詢與擷取最終結果。
如需完整參數參考，請參閱 Kling 官方文件。
授權
Bearer token authentication. Use your CometAPI key.
主體
application/json
Session id returned by identify-face.
One or more face/audio mappings to synthesize.
Minimum array length:
1Show child attributes
Show child attributes
Webhook URL to receive task status updates.
Custom task id for your own tracking. Must be unique per account.
⌘I
cURL
curl https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
}'import os
import requests
response = requests.post(
"https://api.cometapi.com/kling/v1/videos/advanced-lip-sync",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
},
)
result = response.json()
print(result.get("code"), result.get("data", {}).get("task_id"))const response = await fetch("https://api.cometapi.com/kling/v1/videos/advanced-lip-sync", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"session_id": "<session_id>",
"face_choose": [
{
"face_id": "<face_id>",
"sound_file": "https://your-audio-host/speech.wav",
"sound_start_time": "0",
"sound_end_time": "2000",
"sound_insert_time": "0",
"sound_volume": 1,
"original_sound_volume": 0
}
]
}),
});
const result = await response.json();
console.log(result.code, result.data?.task_id);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/kling/v1/videos/advanced-lip-sync",
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([
'session_id' => '<session_id>',
'face_choose' => [
[
'face_id' => '<face_id>',
'sound_file' => 'https://your-audio-host/speech.wav',
'sound_start_time' => '0',
'sound_end_time' => '2000',
'sound_insert_time' => '0',
'sound_volume' => 1,
'original_sound_volume' => 0
]
]
]),
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://api.cometapi.com/kling/v1/videos/advanced-lip-sync"
payload := strings.NewReader("{\n \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\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://api.cometapi.com/kling/v1/videos/advanced-lip-sync")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/kling/v1/videos/advanced-lip-sync")
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 \"session_id\": \"<session_id>\",\n \"face_choose\": [\n {\n \"face_id\": \"<face_id>\",\n \"sound_file\": \"https://your-audio-host/speech.wav\",\n \"sound_start_time\": \"0\",\n \"sound_end_time\": \"2000\",\n \"sound_insert_time\": \"0\",\n \"sound_volume\": 1,\n \"original_sound_volume\": 0\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"message": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}