FaceChain — 图像检测 - 千问 AI 平台

检测图像中是否包含符合要求的人脸

POST

/services/vision/facedetection/detect

cURL

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/vision/facedetection/detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "model": "facechain-facedetect",
  "input": {
    "images": [
      "https://example.com/image1.png",
      "https://example.com/image2.jpg",
      "https://example.com/image3.png"
    ]
  },
  "parameters": {}
}'

{
  "output": {
    "is_face": [
      true,
      false,
      true
    ],
    "failed_reason": [
      "",
      "no face detected",
      ""
    ]
  },
  "usage": {},
  "request_id": "549e0573-f630-9c17-8df2-08f605b4a646"
}

请先获取 API Key 并配置为环境变量。

FaceChain 人物图像检测用于判断输入图像是否包含符合要求的人脸，通常在人物写真生成前作为图像筛选步骤使用。限制：每个账号 QPS 上限为 5。

鉴权

string

header

必填

千问 AI 平台 API Key。详见获取 API Key。

请求体

application/json

enum<string>

必填

模型名称，固定为 facechain-facedetect。

可选值：facechain-facedetect

示例:facechain-facedetect

object

必填

输入图像参数。

显示子属性

string[]

必填

待检测图像的公网可访问 URL 列表。

图像要求：

格式：JPEG、PNG、JPG、WEBP
分辨率：宽和高必须在 256 到 4096 像素之间
文件大小：不超过 5 MB

重要

图片 URL 中如果包含非 ASCII 字符（如中文文件名），需要先进行 URL 编码（percent-encoding），否则可能导致 InternalError.Algo 错误。例如，在 Python 中使用 urllib.parse.quote()，在 JavaScript 中使用 encodeURI() 对 URL 进行编码。

选图建议（用于人物写真生成）：

每张图像仅包含 1 张人脸
五官清晰可见、正面照
人脸区域大于 128x128 像素
避免佩戴墨镜或面部遮挡
避免浓妆

示例:

[
  "https://example.com/image1.png",
  "https://example.com/image2.jpg"
]

object

生成参数。当前无可用参数，传空对象 {} 即可。

显示子属性

响应

200-application/json

string

请求唯一标识符，用于链路追踪和问题排查。

示例:549e0573-f630-9c17-8df2-08f605b4a646

object

检测结果。

显示子属性

boolean[]

每张输入图像的人脸检测结果。true 表示检测到符合要求的人脸，false 表示未检测到。数组顺序与输入图像顺序一致。

示例:

[
  true,
  false,
  true
]

string[]

每张输入图像的检测失败原因。检测通过时为空字符串 ""，未通过时返回具体原因（如 "no face detected"）。数组顺序与输入图像顺序一致。

示例:

[
  "",
  "no face detected",
  ""
]

object

使用量统计。当前为空对象。