Python SDK

Official smallpict-python SDK for Django, FastAPI, Flask, and data pipelines.

The official SmallPict Python package supports synchronous and asynchronous workflows with full type hints (PEP 484).

Installation

Shell

pip install smallpict# orpoetry add smallpict

Quickstart

Python

import osfrom smallpict import SmallPict
client = SmallPict(    api_key=os.environ["SMALLPICT_API_KEY"],    secret_key=os.environ["SMALLPICT_SECRET_KEY"],    max_retries=3)
# 1. Lossy Optimization (Default: 70-85% size reduction)with open("banner.jpg", "rb") as f:    lossy_result = client.optimize(        source=f.read(),        format="avif",        quality=80,        lossless=False  # Default: lossy compression    )print(f"Lossy URL: {lossy_result.url} (Saved {lossy_result.savings_percentage}%)")
# 2. Lossless Mode (Pixel-perfect for logos & graphics)with open("logo.png", "rb") as f:    lossless_result = client.optimize(        source=f.read(),        format="webp",        lossless=True  # Activates pixel-perfect lossless compression    )print(f"Lossless URL: {lossless_result.url} (Saved {lossless_result.savings_percentage}%)")
# 3. Check quotaquota = client.get_quota()print(f"Usage: {quota.bytes_used} bytes used")