リップシンクの顔認識

リップシンク（`kling-lip-sync`）の第 1 ステップ：素材内の顔を認識し、session ID と顔 ID を取得します。

POST/v1/kling/faces

同期エンドポイントで、1 回ごとに課金されます。認識結果にはセッション ID と顔 ID が含まれ、有効期間は 24 時間です。次のステップでそれらを動画タスクを送信の extra.session_id と extra.face_choose（ちょうど 1 項目で、face_id と sound_file を含む）に指定します。流れはリップシンクを参照してください。

リクエストボディは videos 配列のみ受け付けます。各項目は url / file_id のどちらか一方で、規則はメディアの指定方法と同じです。

リップシンクの顔認識

curl https://api.hop-base.com/v1/kling/faces \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "file_id": "source-video-file-id"
      }
    ]
  }'

200application/json

セッション ID と顔 ID を含む JSON を返します。24 時間有効です。

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディJSON

videos:必須array of object

顔を認識する素材。1 項目以上

個数≥ 1 個

レスポンス

200認識結果の JSON。セッション ID と顔 ID を含みます（24 時間有効）

application/json 顔認識の結果

エラー

400リクエストが不適合で、課金されません。原文： request body does not match the JSON contract: …：JSON が不正、表にないフィールドがある、またはリクエストボディの後ろに 2 つ目の JSON 値がある videos is required and must contain at least one item videos[<番号>] must provide exactly one of url or file_id videos[<番号>].url must be a publicly accessible absolute http(s) URL

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

ヘッダー

リクエストボディJSON

レスポンス

エラー

関連ページ