跳转到主要内容
图生播报视频

LivePortrait 图像检测

检测人物肖像图片是否符合 LivePortrait 视频生成模型的输入规范

POST
/services/aigc/image2video/face-detect
cURL
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "model": "liveportrait-detect",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
  }
}'
{
  "output": {
    "pass": true,
    "message": ""
  },
  "usage": {
    "image_count": 1
  },
  "request_id": "a92e2ffd-9263-44ba-92c5-xxxxxx"
}
LivePortrait-detect 模型用于检测输入的图片是否满足 LivePortrait 视频生成所需的人物肖像图片规范,通常在生成数字人播报视频前作为图像筛选步骤使用。

模型概览

模型名模型简介
liveportrait-detect特定的图像检测模型,用于检测输入的图片是否满足 LivePortrait 模型所需的人物肖像图片规范。

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP、WEBP
  • 文件大小:小于 10 MB
  • 宽高比:不超过 2
  • 最大边长:不超过 4096 像素
  • 仅支持 HTTP 或 HTTPS 公网链接,不支持本地路径
如需将本地图像上传获取临时公网 URL,请参考上传文件获取临时 URL

检测不通过原因

output.message原因说明
No human face detected.未检测到人脸(包括人脸过小、侧脸、遮挡等情况)

状态码说明

通用错误码请参阅错误信息

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

请求体

application/json
enum<string>
必填

模型名称,固定为 liveportrait-detect

liveportrait-detect
liveportrait-detect
object
必填

输入图像参数。

响应

200-application/json
string

本次请求的系统唯一码,用于链路追踪和问题排查。

a92e2ffd-9263-44ba-92c5-xxxxxx
object

检测结果。

object

使用量统计。