Tinify API client for Python

Features

Requirements

Installation

pip install tinify

Quick start

importtinify# Set your API key (get one for free at https://tinypng.com/developers)tinify.key="YOUR_API_KEY"# Compress an image from a filetinify.from_file("unoptimized.png").to_file("optimized.png")# Compress from URLtinify.from_url("https://example.com/image.jpg").to_file("optimized.jpg")# Compress from buffersource_data=b"<image data>"tinify.from_buffer(source_data).to_file("optimized.jpg")

Advanced Usage

Resizing

# Scale image to fit within 300x200px while preserving aspect ratiotinify.from_file("original.jpg").resize(method="scale",width=300,height=200).to_file("resized.jpg")# Fit image to exact 300x200px dimensionstinify.from_file("original.jpg").resize(method="fit",width=300,height=200).to_file("resized.jpg")# Cover 300x200px area while preserving aspect ratiotinify.from_file("original.jpg").resize(method="cover",width=300,height=200).to_file("resized.jpg")

Format Conversion

# Convert to WebP formattinify.from_file("image.png").convert(type=["image/webp"]).to_file("image.webp")

# Convert to smallest formatconverted=tinify.from_file("image.png").convert(type=["image/webp","image/webp"])extension=converted.result().extensionconverted.to_file("image."+extension)

Compression Count Monitoring

# Check the number of compressions made this monthcompression_count=tinify.compression_countprint(f"You have made{compression_count} compressions this month")

Error Handling

importtinifytinify.key="YOUR_API_KEY"try:tinify.from_file("unoptimized.png").to_file("optimized.png")excepttinify.AccountErrorase:# Verify or update API keyprint(f"Account error:{e.message}")excepttinify.ClientErrorase:# Handle client errors (e.g., invalid image)print(f"Client error:{e.message}")excepttinify.ServerErrorase:# Handle server errorsprint(f"Server error:{e.message}")excepttinify.ConnectionErrorase:# Handle network connectivity issuesprint(f"Connection error:{e.message}")exceptExceptionase:# Handle general errorsprint(f"Error:{str(e)}")

Running tests

pip install -r requirements.txt -r test-requirements.txtpy.test

tox

Integration tests

pip install -r requirements.txt -r test-requirements.txtTINIFY_KEY=$YOUR_API_KEY py.test test/integration.py

License

Support