glassypic

Optimize an image: smart lossy compression (typically 60-80% size reduction), optional resize/upscale/format conversion, and AI-generated SEO metadata. Accepts absolute local file paths or remote URLs. In remote/API mode, only remote URLs are supported. Supported input formats: JPG, PNG, WebP, AVIF, GIF, SVG, ICO, HEIC, TIFF, BMP (max 50 MB). Supported output formats: JPG, PNG, WebP, AVIF, GIF, SVG, ICO. Credits: 3 to compress (always), +1 if width or height is set, +2 to upscale, +1 for SEO tags (on by default). A full pipeline is 7 credits. Upscale is charged whether you request it or the server adds it automatically — it does so whenever a resize target exceeds the source by more than 1.2x, so a resize-only call on a small image also costs 7. SVG or ICO output is a flat 1 credit, overriding everything above. Animated GIFs are billed per frame: (per-frame operations x frames) + 1 if tags, up to 601 credits at the 100-frame limit — confirm_gif_cost gates that path. GIFs are excluded from automatic upscaling. Works as a guest with no signup. Log in with the login tool for more credits. Use status tool to check remaining credits before batch processing.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "description": "Absolute local file path or remote URL of the image to optimize. Note: in remote/API mode, only remote URLs are supported (no local file paths). Supported inputs: JPG, PNG, WebP, AVIF, GIF (animated supported), HEIC, TIFF, BMP (max 50 MB). GlassyPic supports high-quality conversion between any input and output format."
    },
    "output_path": {
      "type": "string",
      "description": "Where to save. Accepts a file path (/tmp/out.webp) or directory ending in / (/tmp/images/). If omitted: saves next to original, named with SEO slug when SEO is enabled or .polished suffix otherwise. URLs save to current working directory."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "original",
        "jpg",
        "png",
        "webp",
        "avif",
        "gif",
        "svg",
        "ico"
      ],
      "description": "Output format. Defaults to 'original' (keep input format). Animated GIFs stay animated when output is 'gif'; converting to other formats preserves only the first frame. SVG output from raster input uses vector tracing. ICO output generates a favicon set (16, 24, 32, 48, 256px) unless a specific size is given."
    },
    "output_width_px": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Target width in pixels. Set only width for proportional resize. Set both width and height for exact output dimensions (see output_resize_behavior). Costs 1 credit. If the target exceeds the source by more than 1.2x, the server also adds an AI upscale for a further 2 credits."
    },
    "output_height_px": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Target height in pixels. Set only height for proportional resize. Set both width and height for exact output dimensions (see output_resize_behavior). Costs 1 credit. If the target exceeds the source by more than 1.2x, the server also adds an AI upscale for a further 2 credits."
    },
    "output_upscale_factor": {
      "type": "number",
      "enum": [
        2,
        4
      ],
      "description": "AI upscale factor: 2 (2×) or 4 (4×). Uses Real-ESRGAN for high-quality upscaling. Costs 2 credits. Note that upscaling also triggers automatically, without this parameter, whenever a resize target exceeds the source by more than 1.2x — the same 2 credits are charged either way."
    },
    "output_resize_behavior": {
      "type": "string",
      "enum": [
        "pad",
        "crop"
      ],
      "description": "When both width and height are set and aspect ratio differs: 'pad' adds white padding (default), 'crop' smart-crops to fill exact dimensions"
    },
    "output_seo_tag_gen": {
      "type": "boolean",
      "description": "Generate SEO metadata (alt text, keywords, filename) and rename output file to SEO slug. Costs 1 extra credit. Default: true."
    },
    "output_file_size_limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Target maximum output file size in bytes. The server will attempt to meet this limit through additional compression. Not guaranteed."
    },
    "confirm_gif_cost": {
      "type": "boolean",
      "description": "Set to true to proceed with animated GIF processing after seeing cost warning. Required for animated GIFs to prevent unexpected credit consumption."
    },
    "gif_frame_limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum frames to process for animated GIFs (1-100, default 100). Reduces cost by sampling fewer frames while preserving animation."
    },
    "_gif_temp_file_id": {
      "type": "string",
      "description": "Internal: temp file ID from a previous GIF cost warning. Skips re-upload."
    }
  },
  "required": [
    "input"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "output_path": {
      "type": "string",
      "description": "Local server: absolute path where the optimized file was saved. Remote server: an https download URL that works without credentials until it expires (see download_expires_in_seconds); download it promptly."
    },
    "download_expires_in_seconds": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Remote server only: seconds until the output_path download URL expires"
    },
    "output_size_bytes": {
      "type": "number",
      "description": "File size of the optimized image in bytes"
    },
    "output_width_px": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Width of the output image in pixels"
    },
    "output_height_px": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Height of the output image in pixels"
    },
    "output_format": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Output format: jpg, png, webp, avif, gif, svg, or ico"
    },
    "compression_ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Output-to-input size ratio, e.g. 0.35 means 65% smaller"
    },
    "seo_alt_text": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "AI-generated image alt text for accessibility and SEO"
    },
    "seo_keywords": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "AI-generated keywords describing the image"
    },
    "seo_filename": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "AI-generated SEO filename slug without extension"
    }
  },
  "required": [
    "output_path",
    "output_size_bytes",
    "output_width_px",
    "output_height_px",
    "output_format",
    "compression_ratio",
    "seo_alt_text",
    "seo_keywords",
    "seo_filename"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check your GlassyPic account status: login state, tier, credits remaining, and credit reset time. Use this before batch processing to verify sufficient credits.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Open the GlassyPic pricing page in the user's browser, where the account's plan can be reviewed and changed. Call this only when the user asks to change or review their plan.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}