Installation & Platform Setup Hub
Set up SmallPict on WordPress, with a server SDK, or through the REST API.
SmallPict works with WordPress, server-side code, and plain HTTP. Pick the integration that matches your stack.
Choose your platform
- WordPress Plugin: Converts WordPress and WooCommerce media to WebP or AVIF (depending on your plan). You connect your site with a one-time email code.
- Mobile Apps (iOS & Android) (Coming Soon): Compress camera and gallery photos on iPhone and Android, using the same account and quota.
- 7 Official Server SDKs: Libraries for Node.js, Go, Python, PHP, Java/Kotlin, Rust, and Ruby that sign requests for you.
- Direct REST API: OpenAPI 3.1 endpoints authenticated with HMAC-SHA256 signatures.
1. WordPress plugin setup
System requirements
- WordPress: Version 5.8 or higher (Tested up to 6.7+)
- PHP: Version 7.4 to 8.3
- Required Extensions:
curl,json,mbstring
Installation steps
- Navigate to Plugins → Add New in your WordPress Admin dashboard.
- Search for "SmallPict" in the plugin search bar.
- Click Install Now, then click Activate.
- Follow the on-screen OTP onboarding prompt to link your account.
2. SmallPict mobile app (iOS & Android, coming soon)
The mobile app lets creators, photographers, and store owners compress high-resolution photos on their phone before publishing.
Release status: In beta. Planned for the Apple App Store (iOS 15+) and Google Play Store (Android 10+).
Planned features
- Batch processing: Select up to 100 RAW, JPEG, or HEIC images and convert them to AVIF or WebP.
- Smaller files: Typical photos shrink by up to 90% without visible quality loss.
- Shared quota: Sign in with your SmallPict account to use the same monthly quota as your WordPress sites and API keys.
For beta updates, see the mobile app overview.
3. Server SDK installation
Install the SDK for your language:
# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/tuxnoob/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpict4. REST API quickstart
Send an optimization request with cURL. See Authentication for how to compute the signature.
curl -X POST https://api.smallpict.app/v1/optimize \ -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \ -H "X-Timestamp: 1716301234" \ -H "X-Signature: 3a9f8b2c4d6e8a..." \ -H "Content-Type: application/json" \ -d { "filename": "hero.jpg", "mime_type": "image/jpeg", "filesize": 2508800, "options": { "format": "avif", "quality": 80, "max_width": 1920 }}'5. Sandbox testing
To test without using your quota, use sp_test_... credentials. See the sandbox guide.