Skip to main content
POST
cURL
下流の lip-sync ワークフローを実行する前に、このエンドポイントを使用してソース動画内の顔を識別します。

このルートが返すもの

  • 現在の顔検出結果をグループ化する session_id
  • 1つ以上の検出された顔を含む face_data 配列
  • face_id、プレビュー画像、時間範囲などの顔ごとのメタデータ

使用するタイミング

  • ソースは必ず1つだけ送信します: 完了した Kling 動画には video_id、ホストされた MP4 または MOV には video_url
  • 画面上に複数の人物がいる動画の lip-sync リクエストを作成する前
  • 自動選択に頼らず、特定の顔を選ぶ必要がある場合
  • よりコストの高いタスクを開始する前に、顔の検出範囲をプレビューしたい場合
完全なパラメータリファレンスについては、Kling 公式ドキュメントを参照してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
video_id
string
必須

Kling video id from a completed task. Send either video_id or video_url.

video_url
string

Public MP4 or MOV URL. Send either video_id or video_url.

レスポンス

200 - application/json

OK

code
integer
必須
message
string
必須
request_id
string
必須
data
object
必須