认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
可选值: kirin_identify_face
video_id string
视频的 ID
用于指定视频, 并判断视频是否可用于对口型服务
video_id 与 video_url 参数二选一填写, 不能同时为空, 也不能同时有值
video_url string
所上传视频的获取 URL
用于指定视频, 并判断视频是否可用于对口型服务
video_id 与 video_url 参数二选一填写, 不能同时为空, 也不能同时有值
视频要求：
支持格式：.mp4, .mov
文件大小：最大 100MB
时长：2 至 60 秒
分辨率：仅支持 720p 和 1080p
尺寸：宽高均位于 512px 和 2160px 之间
系统会校验视频内容, 如有问题会返回错误码等信息
轮询
由于人脸识别需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现.
code
string错误码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时出现.
content
array生成内容列表
text
string包含人脸识别结果的 JSON 字符串：
code：错误码, 具体定义见错误码
message：错误信息
request_id：请求 ID, 系统生成, 用于跟踪请求、排查问题
data.session_id：会话 ID, 基于视频初始化任务生成, 不会随编辑选区行为而改变, 有效期 24 小时
data.final_unit_deduction：任务最终扣减积分数值
data.face_data：检测到的人脸数组
data.face_data[].face_id：视频中的人脸 ID；同一个人脸在视频中间隔超过 1 秒时会视作不同 ID
data.face_data[].face_image：从视频中截图的人脸的示意图 URL
data.face_data[].start_time：该人脸可对口型区间起点时间, 可作为对口型最佳开始时间
data.face_data[].end_time：该人脸可对口型区间终点时间；注：此结果存在毫秒级误差, 会长于实际区间终点type
string资源类型, 此模型返回
texturl
stringURL（此模型为空）
usage object
使用统计. 仅在状态为 completed 时出现.
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 014002095 | 内部生成错误 |
| 014002096 | 结果解析异常 |
| 014002097 | HTTP 错误响应 |
| 014002099 | 同步生成异常 |