🔑 API & Developer

Getting your API key

1 min read ·

An API key lets you convert images programmatically. Here’s how to get one.

Steps

  1. Create an account at Sign Up. All you need is an email address — we use passwordless sign-in codes.
  2. Go to your dashboard at API Keys.
  3. Click “Generate API Key”. Your key will be shown once — copy it immediately.
  4. Store it securely. The key starts with kp_ followed by 40 hex characters. We store only a SHA-256 hash, so we can’t recover it if you lose it.

Key details

  • Keys are free with no credit card required.
  • Each key has 30 requests/minute and 500 requests/day limits.
  • Anonymous (no-key) requests are limited to 10/minute and 50/day.
  • You can generate multiple keys and revoke them individually.
  • API keys are passed via the X-API-Key header.

Security

  • Never commit API keys to version control.
  • Use environment variables to store keys in your application.
  • Revoke compromised keys immediately from your dashboard.
Was this helpful?

Thanks for your feedback!

← Back to API & Developer

Related Articles

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...

1 min read

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...

1 min read

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...

1 min read

Looking for something else?

Send Feedback

Thank you! We'll get back to you soon.

Install KoalaPic

Add to your home screen for quick access

Cookie & Storage Preferences

We use cookies and local storage to improve your experience. Essential storage is always active for core functionality. Learn more

Essential

CSRF protection, dark mode, error tracking. Always active.

Functional

Conversion presets, UI preferences, PWA install state.

Analytics

Anonymous usage statistics to improve the service.