Microsoft Face API - 400请求正文无效

Microsoft Face API - 400请求正文无效问题解析

基础概念

Microsoft Face API是微软认知服务(Cognitive Services)的一部分，提供人脸检测、识别、验证和分组等功能。400错误通常表示客户端发送的请求存在格式或内容问题，服务器无法处理。

可能原因及解决方案

1. 请求正文格式错误

原因：请求正文不符合API要求的JSON格式规范。

解决方案：

确保请求头中包含Content-Type: application/json
检查JSON格式是否正确，无语法错误

// 正确示例
{
    "url": "https://example.com/image.jpg"
}

// 错误示例（缺少引号）
{
    url: "https://example.com/image.jpg"
}

2. 必填字段缺失

原因：缺少API操作所需的必填字段。

解决方案：

检查API文档，确保包含所有必填字段
对于人脸检测，至少需要提供url或data字段

3. 图像URL无效

原因：提供的图像URL无法访问或格式不正确。

解决方案：

确保URL指向有效的图像文件
检查URL是否可公开访问
验证图像格式是否受支持（JPEG, PNG, GIF, BMP）

4. 图像数据无效

原因：直接上传的图像数据格式不正确或损坏。

解决方案：

确保图像数据正确编码（如base64）
验证图像文件未损坏

5. 请求大小超出限制

原因：图像文件过大（通常限制为4MB或6MB）。

解决方案：

压缩图像文件
调整图像分辨率

示例代码

import requests
import json

# 正确的API调用示例
subscription_key = "YOUR_SUBSCRIPTION_KEY"
endpoint = "https://YOUR_REGION.api.cognitive.microsoft.com/face/v1.0/detect"

headers = {
    'Content-Type': 'application/json',
    'Ocp-Apim-Subscription-Key': subscription_key
}

params = {
    'returnFaceId': 'true',
    'returnFaceLandmarks': 'false',
    'returnFaceAttributes': 'age,gender,emotion'
}

body = {
    'url': 'https://example.com/person.jpg'
}

try:
    response = requests.post(endpoint, headers=headers, params=params, json=body)
    response.raise_for_status()
    print(json.dumps(response.json(), indent=2))
except requests.exceptions.HTTPError as err:
    print(f"HTTP Error: {err}")
    print(f"Response: {err.response.text}")
except Exception as err:
    print(f"Error: {err}")