# Get Face Entity Face And Body Analysis

Use this visual AI API when the task needs the visual analysis task described by action 查询人脸数据库中的实体信息。. Send the schema keys exactly as listed (DbName, EntityId); required parameters: DbName, EntityId.

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-database-get-entity`
- Canonical service ID: `face-database-get-entity`
- Legacy internal service ID: `aliyun-facebody-get-face-entity`
- Method: `POST`
- Endpoint: `https://aivps.lat/api/tools/face-database-get-entity`
- Legacy endpoint: `https://aivps.lat/api/tools/aliyun-facebody-get-face-entity`
- Service page: https://aivps.lat/services/face-database-get-entity
- OpenAPI: https://aivps.lat/openapi.json
- Catalog search: https://aivps.lat/api/catalog/search?q=face-database-get-entity
- MCP endpoint: https://aivps.lat/mcp
- MCP tool: `face_database_get_entity`

## 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-database-get-entity", then pass the returned token in X-Payment-Token or MCP paymentToken.

## Use Cases

- the visual analysis task described by action 查询人脸数据库中的实体信息。
- 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

GetFaceEntity, 阿里云人脸人体 查询人脸实体, face detection, body detection, pose estimation, face recognition, liveness detection, human analysis, get, face, entity

## 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": {
    "DbName": {
      "description": "Alibaba Cloud face database or template identifier.",
      "type": "string"
    },
    "EntityId": {
      "description": "Alibaba Cloud face database or template identifier.",
      "type": "string"
    }
  },
  "required": [
    "DbName",
    "EntityId"
  ],
  "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
{
  "DbName": "example-face-db",
  "EntityId": "example-entity-id"
}
```

## Example Response

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