image

Compress an image. POST exactly one of { url } or {...

Compress an image. POST exactly one of { url } or { imageBase64 }, plus optional { format?: auto|png|jpeg|webp|avif (default auto = keep input format), quality?: 1-100 (default 75), lossy?: bool (default true), effort?: 1-10 (default 6) }. Returns compressed image bytes directly with X-2s-* headers: Original-Bytes, Compressed-Bytes, Saved-Percent, Output-Format, Source-Format, Source-Width, Source-Height, Process-Ms. Limits: 5MB URL fetch, ~3MB inline body, 4096 × 4096 input pixels. Animated GIF input becomes animated WebP when format=webp or auto.

post/api/image/compress

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/image/compress
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Request body

urlstring uri

URL to process.

imageBase64string

Image base64.

format'auto' | 'png' | 'jpeg' | 'webp' | 'avif'

Format.

qualityinteger

Quality.

lossyboolean

Lossy.

effortinteger

Effort.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.