跳转到主要内容
POST
/
kling
/
v1
/
videos
/
identify-face
cURL
curl https://api.cometapi.com/kling/v1/videos/identify-face \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "video_url": "https://your-video-host/face-video.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
  • 包含一个或多个人脸的 face_data 数组
  • 每张人脸的元数据，例如 face_id、预览图像和时间范围

​
何时使用

  • 在为屏幕中有多个人物的视频构建口型同步请求之前
  • 当你需要选择特定人脸，而不是依赖自动选择时
  • 当你希望在启动成本更高的任务之前预览人脸覆盖范围时
完整参数参考，请参阅 Kling 官方文档。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
​
video_url
string
默认值:https://your-video-host/source.mp4
必填

Public URL of the video to analyze for face identification.

响应

200 - application/json

OK

​
code
integer
必填
​
message
string
必填
​
request_id
string
必填
​
data
object
必填