创建视频生成任务-人脸识别
本接口用于发起视频人脸识别分析，作为对口型服务的前置首要步骤。任务创建成功后，将返回 session_id，用于后续调用创建视频生成任务-对口型接口。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
模型名称。
固定值：K-Identify-Face。
任务类型。
固定值：lip-sync（人脸识别）。
支持模型范围：K-Identify-Face。
人脸识别模型专用参数。
显示子属性
隐藏子属性
通过 K 系列模型生成的视频的 ID。
用于指定视频、判断视频是否可用于对口型服务。
与 video_url 参数二选一填写，不能同时为空，也不能同时有值。
仅支持使用 30 天内生成的时长不超过 60 秒的视频。
所上传视频的获取 URL。
用于指定视频，并判断视频是否可用于对口型服务。
与 video_id 参数二选一填写，不能同时为空，也不能同时有值。
视频文件支持 .mp4/.mov，文件大小不超过 100MB，视频时长不超过 60s 且不短于 2s，仅支持 720p 和 1080p、长宽的边长均位于 512px~2160px 之间，上述校验不通过会返回错误码等信息。
系统会校验视频内容，如有问题会返回错误码等信息。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "K-Identify-Face",
"type": "lip-sync",
"model_parameters": {
"video_url": "https://testdde.bj.bcebos.com/video.mp4"
}
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/qianfan-video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-l************E/44232860c02a8067b9eed2e5e3ff4b8cd25192e5' \
--data '{
"model": "K-Identify-Face",
"type": "lip-sync",
"model_parameters": {
"video_url": "https://testdde.bj.bcebos.com/video.mp4"
}
}'返回响应
错误码；具体定义见错误码文档。
成功时固定返回 0。
错误信息。
成功时返回 SUCCEED。
请求 ID，系统生成，用于跟踪请求、排查问题。
返回数据体，包含人脸识别相关信息。
显示子属性
隐藏子属性
会话 ID，供"创建对口型任务"接口的 session_id 参数使用。
识别到的人脸列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
人脸 ID，供"创建对口型任务"接口 face_choose.face_id 参数使用。
该人脸的预览图 URL。
该人脸可对口型的时间区间起点，单位 ms。
该人脸可对口型的时间区间终点，单位 ms。
本次调用最终消耗积分数值，单位：个
{
"code": 0,
"message": "SUCCEED",
"request_id": "as-abe0dc6zuf",
"data": {
"session_id": "905*****38524",
"face_data": [
{
"face_id": "-1",
"face_image": "https://p2-fdl.*******XOn3plIXj0OPP-flMDCs4piDowKCnCVC5Lq9GvLDCwhICQUj-jt1CubtdhC3DzURC5U0SmaCvXj-3WiadfE.jpg?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSYCPNyq1hHNyCVTJOSBllGOetL3ctdr8bLu7i0yrlIDdPCb6UbF6u3NzIY3OPRYrxixNdKT33EeO060CaUORbLhnzAG8LGJsY_xfbE6KgBIUvyIs1CDXSIqveqcTsNbXrrBoS0dDQ6WvEt8pqXaoyQyeDsp12IiC9Ujjgv0CGmoyYABcUu3VxhKXM8FBrGK_8zLS84m0GESgFMAE&x-kcdn-pid=112757&pkey=AAVaSn39bBXMplcGnbAOtkQbdgUkv6YTFHW5h7WHSlaHFF3_uYHO0lbhbhbLRmVFuSAkK8024k1FdgHwgdVfT80ETFUri37BhNqnl7FMeIft3ltnBtwY6RIW39roTOsOBrQ",
"start_time": 0,
"end_time": 5300
}
],
"final_unit_deduction": "0.05"
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 0 | 请求成功 | - | - |
| 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
| 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
| 1201 | 请求参数非法 | 参数非法，如key写错或value非法 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1202 | 请求参数非法 | 请求的method无效 | 查看接口文档，使用正确的request method |
| 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
| 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
| 5000 | 内部错误 | 服务器内部错误 | 稍后重试，或联系客服 |
| 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | 稍后重试，或联系客服 |
| 5002 | 内部错误 | 服务器内部超时，通常是发生积压 | 稍后重试，或联系客服 |
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_genration_interal_error | video generation service interal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章