# maskcircleimage: Mask an Image with a Circle Mask

> maskcircleimage (Mask an Image with a Circle Mask) is a 1001fx API function in the group Images: POST https://api.1001fx.com/images/maskcircleimage, 3 credits per call. It works as a ready-made module in Make and n8n or as a plain HTTP call.

Creates an image with a circle mask.

- Group: Images
- Endpoint: `POST https://api.1001fx.com/images/maskcircleimage`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: multipart/form-data
- Credits: 3 credits per call
- Ready-made in: Make and n8n
- Docs: https://1001fx.com/functions/maskcircleimage

## Parameters

- `radius` (number, required, min 1) – Radius: The radius for your circle
- `x` (number, optional, default `0`) – X coordinate: The horizontal position of your circle center. Defaults to 0.
- `y` (number, optional, default `0`) – Y coordinate: The vertical position of your circle center. Defaults to 0.
- `file` (file, required) – Image file: Image file to be processed.

## Example: Image circle

```bash
curl -X POST 'https://api.1001fx.com/images/maskcircleimage' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -F 'file=@1600x900.png' \
  -F 'radius=100' \
  -F 'x=50' \
  -F 'y=50'
```
