# Merge Image Face 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 (AddWatermark, ImageURL, MergeInfos, ModelVersion, TemplateId, WatermarkType); required parameters: ImageURL, MergeInfos, TemplateId.

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

## 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-swap-template-merge", 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

MergeImageFace, 阿里云人脸人体 图像人脸融合, face detection, body detection, pose estimation, face recognition, liveness detection, human analysis, merge, image, face

## 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": {
    "AddWatermark": {
      "description": "Alibaba Cloud RPC parameter AddWatermark.",
      "type": "boolean"
    },
    "ImageURL": {
      "description": "Public http or https image URL accepted by the Alibaba Cloud API.",
      "format": "uri",
      "type": "string"
    },
    "MergeInfos": {
      "description": "Alibaba Cloud JSON array parameter. A JSON string is also accepted and forwarded as-is.",
      "type": "array"
    },
    "ModelVersion": {
      "description": "Alibaba Cloud RPC parameter ModelVersion.",
      "type": "string"
    },
    "TemplateId": {
      "description": "Alibaba Cloud face database or template identifier.",
      "type": "string"
    },
    "WatermarkType": {
      "description": "Alibaba Cloud RPC parameter WatermarkType.",
      "type": "string"
    }
  },
  "required": [
    "ImageURL",
    "MergeInfos",
    "TemplateId"
  ],
  "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",
  "MergeInfos": [
    {
      "ImageURL": "https://example.com/face.jpg",
      "TemplateFaceID": "face-1"
    }
  ],
  "TemplateId": "example-template-id"
}
```

## Example Response

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