Paid API service

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.

Invocation

Service ID: face-swap-template-merge
Method: POST
Endpoint: /api/tools/face-swap-template-merge
Legacy Endpoint: /api/tools/aliyun-facebody-merge-image-face
MCP Tool: face_swap_template_merge
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.

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.

Schema And Examples

{
  "exampleRequest": {
    "ImageURL": "https://example.com/image.jpg",
    "MergeInfos": [
      {
        "ImageURL": "https://example.com/face.jpg",
        "TemplateFaceID": "face-1"
      }
    ],
    "TemplateId": "example-template-id"
  },
  "exampleResponse": {
    "code": "200",
    "content": "",
    "data": {
      "Action": "MergeImageFace",
      "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": {
      "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"
  },
  "outputSchema": {
    "properties": {
      "code": {
        "type": "string"
      },
      "content": {
        "type": "string"
      },
      "data": {
        "type": "object"
      },
      "message": {
        "type": "string"
      },
      "requestId": {
        "type": "string"
      }
    },
    "required": [
      "requestId",
      "data"
    ],
    "type": "object"
  }
}