Paid API service

Recognize Face Face And Body Analysis

Use this visual AI API when the task needs recognizing face attributes such as age, gender, expression, and mask status. Send the schema keys exactly as listed (Age, Beauty, Expression, Gender, Glass, Hat, ImageURL, Mask, MaxFaceNumber, Quality); required parameters: ImageURL.

Invocation

Service ID: face-attribute-recognition
Method: POST
Endpoint: /api/tools/face-attribute-recognition
Legacy Endpoint: /api/tools/aliyun-facebody-recognize-face
MCP Tool: face_attribute_recognition
Price: USD 0.20

Payment

Call the endpoint without payment to receive HTTP 402 metadata. After payment is complete, retry with X-Payment-Token, an x402 payment signature, or MCP paymentToken.

Call POST /api/tools/face-attribute-recognition once to receive HTTP 402 with accepts[] requirements, or create a payment with POST /api/payments using serviceId="face-attribute-recognition". Pay Base USDC with PAYMENT-SIGNATURE or pay XIAO with X402-Guarantee, then retry the same request.

Schema And Examples

{
  "exampleRequest": {
    "ImageURL": "https://example.com/image.jpg"
  },
  "exampleResponse": {
    "code": "200",
    "content": "",
    "data": {
      "Action": "RecognizeFace",
      "Result": "example result from Alibaba Cloud facebody"
    },
    "message": "success",
    "requestId": "example-request-id"
  },
  "inputSchema": {
    "description": "Use Alibaba Cloud RPC parameter names exactly, for example ImageURL, ImageUrl, Url, URL, JobId, or Tasks depending on the service.",
    "properties": {
      "Age": {
        "description": "Alibaba Cloud RPC parameter Age.",
        "type": "boolean"
      },
      "Beauty": {
        "description": "Alibaba Cloud RPC parameter Beauty.",
        "type": "boolean"
      },
      "Expression": {
        "description": "Alibaba Cloud RPC parameter Expression.",
        "type": "boolean"
      },
      "Gender": {
        "description": "Alibaba Cloud RPC parameter Gender.",
        "type": "boolean"
      },
      "Glass": {
        "description": "Alibaba Cloud RPC parameter Glass.",
        "type": "boolean"
      },
      "Hat": {
        "description": "Alibaba Cloud RPC parameter Hat.",
        "type": "boolean"
      },
      "ImageURL": {
        "description": "Public http or https image URL accepted by the Alibaba Cloud API.",
        "format": "uri",
        "type": "string"
      },
      "Mask": {
        "description": "Alibaba Cloud RPC parameter Mask.",
        "type": "boolean"
      },
      "MaxFaceNumber": {
        "description": "Alibaba Cloud RPC parameter MaxFaceNumber.",
        "type": "number"
      },
      "Quality": {
        "description": "Alibaba Cloud RPC parameter Quality.",
        "type": "boolean"
      }
    },
    "required": [
      "ImageURL"
    ],
    "type": "object"
  },
  "outputSchema": {
    "properties": {
      "code": {
        "type": "string"
      },
      "content": {
        "type": "string"
      },
      "data": {
        "type": "object"
      },
      "message": {
        "type": "string"
      },
      "requestId": {
        "type": "string"
      }
    },
    "required": [
      "requestId",
      "data"
    ],
    "type": "object"
  }
}