调用Microsoft Face API报ResourceNotFound错误求助

我一眼就发现核心问题了——你的face_api_url缺少了具体的API操作路径！Microsoft Face API的v1.0基础端点必须搭配具体功能接口路径，比如人脸检测的/detect，否则服务器无法识别你要调用的功能，自然会返回资源未找到的错误。

具体修正步骤 #

• 补全API端点路径
  把你的face_api_url修改为包含/detect的完整路径：

  face_api_url = 'https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect'
  

  /detect是人脸检测接口的必填后缀，所有提交图片检测人脸的请求都必须指向这个具体地址。

• 验证区域与密钥匹配
  确认你的订阅密钥确实属于westcentralus区域：

  • 如果你在Azure上创建的Face资源是其他区域（比如eastus），需要同步修改端点为对应区域的地址，例如https://eastus.api.cognitive.microsoft.com/face/v1.0/detect
  • 可以登录Azure门户，进入你的Face资源的「密钥和端点」页面，核对区域、密钥与端点的对应关系。

• 确认请求参数合法性
  你的请求方法、headers和参数配置都是正确的，修正端点后就能正常触发人脸检测逻辑。

修正后的完整代码 #

subscription_key = '你的订阅密钥'
assert subscription_key
# 补全/detect路径
face_api_url = 'https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect'
image_url = 'https://how-old.net/Images/faces2/main007.jpg'
import requests
from IPython.display import HTML

headers = {
    'Ocp-Apim-Subscription-Key': subscription_key
}

params = {
    'returnFaceId': 'true',
    'returnFaceLandmarks': 'false',
    'returnFaceAttributes': 'age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise',
}

response = requests.post(face_api_url, params=params, headers=headers, json={"url": image_url})
faces = response.json()
print(faces)

额外排查小贴士 #

• 如果仍有报错，可以打印response.status_code查看具体状态码：401代表密钥无效，403代表权限问题，404大概率还是路径/区域不匹配
• 确认你的Face资源在Azure门户中处于正常启用状态，没有被暂停或删除

内容的提问来源于stack exchange，提问作者KHS