API & Developer
API keys, quickstart guides, rate limits, and webhook setup.
Getting your API key
An API key lets you convert images programmatically. Here’s how to get one. Steps Create an account at Sign Up. All you need is an email address — we use passwordless sign-in codes. Go to your dashboard at API Keys. Click “Generate API Key”. Your key will be shown once — copy...
Your first API conversion in 30 seconds
Get started with the KoalaPic API in under 30 seconds. For the full step-by-step tutorial with code examples in curl, Python, JavaScript, and PHP, see the API Quickstart Guide. Quick overview POST your image to /api/v1/convert (file upload) or /api/v1/convert/url (URL) Poll the status endpoint...
API rate limits explained
KoalaPic uses rate limiting to ensure fair access for all users. Rate limit tiers Tier Per Minute Per Day Authenticated (API key) 30 500 Anonymous (no key) 10 50 How it works Every API response includes rate limit headers: X-RateLimit-Limit-Minute — Your per-minute...
Setting up webhooks
Webhooks let you receive notifications when conversions complete, instead of polling the API. Setup Go to your Webhooks dashboard. Click “Add Webhook URL”. Enter your endpoint URL (must be HTTPS). Copy the signing secret — you’ll need it to verify payloads. Webhook...