Paid API service

Batch Add Faces 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, Faces, QualityScoreThreshold, SimilarityScoreThresholdBetweenEntity, SimilarityScoreThresholdInEntity); required parameters: DbName, EntityId, Faces.

Invocation

Service ID: face-database-batch-add
Method: POST
Endpoint: /api/tools/face-database-batch-add
Legacy Endpoint: /api/tools/aliyun-facebody-batch-add-faces
MCP Tool: face_database_batch_add
Price: XIAO 0.2

Payment

Call the endpoint without payment to receive HTTP 402 metadata. If payment is required, open xiaopay.top to obtain XIAO, create the guarantee, then retry with X-Payment-Token, an XIAO guarantee header, or MCP paymentToken.

Call POST /api/tools/face-database-batch-add once to receive HTTP 402 with accepts[] requirements. Open https://xiaopay.top to obtain XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId, then retry with X402-Guarantee. If you need the legacy reusable token flow, create a payment with POST /api/payments using serviceId="face-database-batch-add".

Schema And Examples

{
  "exampleRequest": {
    "DbName": "example-face-db",
    "EntityId": "example-entity-id",
    "Faces": [
      {
        "ImageUrl": "https://example.com/face.jpg"
      }
    ]
  },
  "exampleResponse": {
    "code": "200",
    "content": "",
    "data": {
      "Action": "BatchAddFaces",
      "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": {
      "DbName": {
        "description": "Alibaba Cloud face database or template identifier.",
        "type": "string"
      },
      "EntityId": {
        "description": "Alibaba Cloud face database or template identifier.",
        "type": "string"
      },
      "Faces": {
        "description": "Alibaba Cloud JSON array parameter. A JSON string is also accepted and forwarded as-is.",
        "type": "array"
      },
      "QualityScoreThreshold": {
        "description": "Alibaba Cloud RPC parameter QualityScoreThreshold.",
        "type": "number"
      },
      "SimilarityScoreThresholdBetweenEntity": {
        "description": "Alibaba Cloud RPC parameter SimilarityScoreThresholdBetweenEntity.",
        "type": "number"
      },
      "SimilarityScoreThresholdInEntity": {
        "description": "Alibaba Cloud RPC parameter SimilarityScoreThresholdInEntity.",
        "type": "number"
      }
    },
    "required": [
      "DbName",
      "EntityId",
      "Faces"
    ],
    "type": "object"
  },
  "outputSchema": {
    "properties": {
      "code": {
        "type": "string"
      },
      "content": {
        "type": "string"
      },
      "data": {
        "type": "object"
      },
      "message": {
        "type": "string"
      },
      "requestId": {
        "type": "string"
      }
    },
    "required": [
      "requestId",
      "data"
    ],
    "type": "object"
  }
}