# 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.

This is a paid API service exposed by Server402 for AI agents, MCP clients, OpenAPI importers, and applications. Call the endpoint once without payment to receive HTTP 402 payment instructions, complete payment, then retry with the returned payment token or x402 signature.

## Invocation

- Service ID: `face-attribute-recognition`
- Canonical service ID: `face-attribute-recognition`
- Legacy internal service ID: `aliyun-facebody-recognize-face`
- Method: `POST`
- Endpoint: `https://aivps.lat/api/tools/face-attribute-recognition`
- Legacy endpoint: `https://aivps.lat/api/tools/aliyun-facebody-recognize-face`
- Service page: https://aivps.lat/services/face-attribute-recognition
- OpenAPI: https://aivps.lat/openapi.json
- Catalog search: https://aivps.lat/api/catalog/search?q=face-attribute-recognition
- MCP endpoint: https://aivps.lat/mcp
- MCP tool: `face_attribute_recognition`

## Pricing And Payment

- Price: USD 0.20
- Billing mode: `per_call`
- Max calls per payment: `1`
- Payment provider: `x402_facilitator`
- Payment flow: call without payment, receive `402 Payment Required`, pay, then retry with `X-Payment-Token` or `PAYMENT-SIGNATURE`.
- Payment hint: Create a payment with POST /api/payments using serviceId="face-attribute-recognition", then pass the returned token in X-Payment-Token or MCP paymentToken.

## Use Cases

- recognizing face attributes such as age, gender, expression, and mask status
- Call one focused visual AI capability directly with JSON inputs
- Use public image or video URLs and structured parameters to get machine-readable results

## Keywords

RecognizeFace, 阿里云人脸人体 人脸属性识别, face detection, body detection, pose estimation, face recognition, liveness detection, human analysis, recognize, face, face attributes, face landmarks, face quality

## Input Schema

```json
{
  "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"
}
```

## Output Schema

```json
{
  "properties": {
    "code": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "data": {
      "type": "object"
    },
    "message": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    }
  },
  "required": [
    "requestId",
    "data"
  ],
  "type": "object"
}
```

## Example Request

```json
{
  "ImageURL": "https://example.com/image.jpg"
}
```

## Example Response

```json
{
  "code": "200",
  "content": "",
  "data": {
    "Action": "RecognizeFace",
    "Result": "example result from Alibaba Cloud facebody"
  },
  "message": "success",
  "requestId": "example-request-id"
}
```