circle_crop

verifiedv0.1

Crop one raster into a circular transparent PNG in the browser. Pass image { mime, base64 } (max 12 MiB decoded). size is the output square edge (16–4096, default 512). zoom 1–8 and offsetX/offsetY pan in output pixels; omitted zoom/offsets mean cover-centered. Variant URLs are not a second machine Tool — pass size explicitly for discord (512) or twitter (400). Do not upload.

Updated 9/3/2026 · Created 9/3/2026

Input Schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "image"
  ],
  "properties": {
    "size": {
      "type": "integer",
      "default": 512,
      "maximum": 4096,
      "minimum": 16
    },
    "zoom": {
      "type": "number",
      "default": 1,
      "maximum": 8,
      "minimum": 1
    },
    "image": {
      "type": "object",
      "required": [
        "mime",
        "base64"
      ],
      "properties": {
        "mime": {
          "enum": [
            "image/jpeg",
            "image/png",
            "image/webp",
            "image/avif",
            "image/heic",
            "image/heif",
            "image/jxl"
          ],
          "type": "string"
        },
        "base64": {
          "type": "string",
          "maxLength": 16777220,
          "minLength": 1
        }
      },
      "additionalProperties": false
    },
    "label": {
      "enum": [
        "generic",
        "discord",
        "twitter"
      ],
      "type": "string",
      "default": "generic"
    },
    "offsetX": {
      "type": "number",
      "default": 0
    },
    "offsetY": {
      "type": "number",
      "default": 0
    }
  },
  "additionalProperties": false
}

Full Contract

{
  "name": "circle_crop",
  "description": "Crop one raster into a circular transparent PNG in the browser. Pass image { mime, base64 } (max 12 MiB decoded). size is the output square edge (16–4096, default 512). zoom 1–8 and offsetX/offsetY pan in output pixels; omitted zoom/offsets mean cover-centered. Variant URLs are not a second machine Tool — pass size explicitly for discord (512) or twitter (400). Do not upload.",
  "inputSchema": {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "image"
    ],
    "properties": {
      "size": {
        "type": "integer",
        "default": 512,
        "maximum": 4096,
        "minimum": 16
      },
      "zoom": {
        "type": "number",
        "default": 1,
        "maximum": 8,
        "minimum": 1
      },
      "image": {
        "type": "object",
        "required": [
          "mime",
          "base64"
        ],
        "properties": {
          "mime": {
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp",
              "image/avif",
              "image/heic",
              "image/heif",
              "image/jxl"
            ],
            "type": "string"
          },
          "base64": {
            "type": "string",
            "maxLength": 16777220,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "label": {
        "enum": [
          "generic",
          "discord",
          "twitter"
        ],
        "type": "string",
        "default": "generic"
      },
      "offsetX": {
        "type": "number",
        "default": 0
      },
      "offsetY": {
        "type": "number",
        "default": 0
      }
    },
    "additionalProperties": false
  }
}

GET /api/tool/simpletoolstack.com/circle_crop