人脸识别
POST /v1/videos/identify-face：识别视频中可对口型的人脸，对口型的前置步骤，同步
POST/v1/videos/identify-face
识别视频中可以对口型的人脸，得到后续创建对口型任务需要的 session_id 和 face_id。
| 项 | 值 |
|---|---|
| 模式 | 同步 |
| 计费 | 每次成功识别计费一次 |
快速开始
curl https://api.vibelab.me/v1/videos/identify-face \
-H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://example.com/talk.mp4"
}'响应示例：
{
"code": 0,
"message": "SUCCEED",
"request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
"data": {
"session_id": "850508686686064678",
"face_data": [
{
"face_id": "0",
"face_image": "https://example.com/face0.png",
"start_time": 0,
"end_time": 5200
}
]
}
}请求参数
请求头
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
Authorization | string | 是 | - | Bearer $LOOPTOKEN_API_KEY |
Content-Type | string | 是 | - | application/json |
请求体
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
video_url | string | 是 | - | 视频地址；mp4/mov，不超过 100MB，2–60 秒，720p 或 1080p，边长 512–2160px。不支持 video_id |
响应
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 0 表示成功，其余见错误 |
message | string | 错误信息 |
request_id | string | 请求 ID，排查问题时提供 |
data.session_id | string | 会话 ID，只有识别它的账号可以使用 |
data.face_data[].face_id | string | 人脸 ID |
data.face_data[].face_image | string | 人脸图片地址 |
data.face_data[].start_time、end_time | integer | 人脸出现的起止时间，毫秒 |
计费
每次成功识别计费一次；识别失败不收费。
错误
本页参数校验返回 400 / 1201，message 原文如下：
| HTTP | code | 触发场景 | 处理 |
|---|---|---|---|
| 400 | 1201 | request body must be a JSON object | 请求体传 JSON 对象 |
| 400 | 1201 | video_url is required and must be a string | 传 video_url |
| 400 | 1201 | video_id is not supported, use video_url | 改传 video_url |
通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。
注意事项
- 会话归属 →
session_id只有识别它的账号可以使用。