Paid API service

Segment Head Image Segmentation

Use this visual AI API when the task needs segmenting head or avatar regions in an image. Send the schema keys exactly as listed (ImageURL, ReturnForm); required parameters: ImageURL.

Invocation

Service ID: head-segmentation
Method: POST
Endpoint: /api/tools/head-segmentation
Legacy Endpoint: /api/tools/aliyun-imageseg-segment-head
MCP Tool: head_segmentation
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.

Call POST /api/tools/head-segmentation once to receive HTTP 402 with accepts[] requirements, or create a payment with POST /api/payments using serviceId="head-segmentation". Pay Base USDC with PAYMENT-SIGNATURE or pay XIAO with X402-Guarantee, then retry the same request.

Schema And Examples

{
  "exampleRequest": {
    "ImageURL": "https://example.com/image.jpg"
  },
  "exampleResponse": {
    "code": "200",
    "content": "",
    "data": {
      "Action": "SegmentHead",
      "Result": "example result from Alibaba Cloud imageseg"
    },
    "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": {
      "ImageURL": {
        "description": "Public http or https image URL accepted by the Alibaba Cloud API.",
        "format": "uri",
        "type": "string"
      },
      "ReturnForm": {
        "description": "Alibaba Cloud RPC parameter ReturnForm.",
        "type": "string"
      }
    },
    "required": [
      "ImageURL"
    ],
    "type": "object"
  },
  "outputSchema": {
    "properties": {
      "code": {
        "type": "string"
      },
      "content": {
        "type": "string"
      },
      "data": {
        "type": "object"
      },
      "message": {
        "type": "string"
      },
      "requestId": {
        "type": "string"
      }
    },
    "required": [
      "requestId",
      "data"
    ],
    "type": "object"
  }
}