APIリファレンス
統合ガイド
エラー
料金・請求
kling
Lip-Sync
Kling Lip-Sync API（POST /kling/v1/videos/identify-face）を使用して動画内の顔を検出し、高精度なリップシンク動画生成ワークフローを実行します。
POST
/
kling
/
v1
/
videos
/
identify-face
Lip-Sync
curl --request POST \
--url https://api.cometapi.com/kling/v1/videos/identify-face \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"session_id": "<string>",
"face_data": [
{
"face_id": "<string>",
"face_image": "<string>",
"start_time": 123,
"end_time": 123
}
]
}
}このエンドポイントを使用すると、後続のリップシンクワークフローを実行する前に、元動画内の顔を特定できます。
このルートが返すもの
- 現在の顔検出結果をまとめる
session_id - 1つ以上の検出された顔を含む
face_data配列 face_id、プレビュー画像、時間範囲などの顔ごとのメタデータ
使用するタイミング
- 画面内に複数の人物がいる動画に対してリップシンクリクエストを作成する前
- 自動選択に頼らず、特定の顔を選択する必要がある場合
- より高コストなタスクを開始する前に、顔の検出範囲をプレビューしたい場合
完全なパラメータリファレンスについては、Klingの公式ドキュメントを参照してください。
承認
Bearer token authentication. Use your CometAPI key.
ボディ
application/json
Public URL of the video to analyze for face identification.
⌘I
Lip-Sync
curl --request POST \
--url https://api.cometapi.com/kling/v1/videos/identify-face \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"session_id": "<string>",
"face_data": [
{
"face_id": "<string>",
"face_image": "<string>",
"start_time": 123,
"end_time": 123
}
]
}
}