# Change Sky Image Segmentation

Use this visual AI API when the task needs replacing the sky region in an image. Send the schema keys exactly as listed (ImageURL, ReplaceImageURL); required parameters: ImageURL, ReplaceImageURL.

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: `sky-replacement`
- Canonical service ID: `sky-replacement`
- Legacy internal service ID: `aliyun-imageseg-change-sky`
- Method: `POST`
- Endpoint: `https://aivps.lat/api/tools/sky-replacement`
- Legacy endpoint: `https://aivps.lat/api/tools/aliyun-imageseg-change-sky`
- Service page: https://aivps.lat/services/sky-replacement
- OpenAPI: https://aivps.lat/openapi.json
- Catalog search: https://aivps.lat/api/catalog/search?q=sky-replacement
- MCP endpoint: https://aivps.lat/mcp
- MCP tool: `sky_replacement`

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

## Use Cases

- replacing the sky region in an image
- 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

ChangeSky, 阿里云分割抠图 天空替换, image segmentation, background removal, cutout, matting, mask generation, foreground extraction, change, sky

## 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": {
    "ImageURL": {
      "description": "Public http or https image URL accepted by the Alibaba Cloud API.",
      "format": "uri",
      "type": "string"
    },
    "ReplaceImageURL": {
      "description": "Public http or https auxiliary image URL accepted by the Alibaba Cloud API.",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "ImageURL",
    "ReplaceImageURL"
  ],
  "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",
  "ReplaceImageURL": "https://example.com/mask-or-replacement.jpg"
}
```

## Example Response

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