imgbtGetting Started
Quick Start
Upload your first image to imgbt in under 5 minutes.
Quick Start
Get started with imgbt by uploading your first image.
1. Get Your API Keys
Sign up at app.imgbt.com and create a vault. Each vault comes with a public key (pk_*) for read-only access and a secret key (sk_*) for full access.
2. Upload an Image
curl -X POST https://your-vault.imgbt.com/api/v1/vaults/{vaultId}/assets \
-H "Authorization: Bearer sk_your_secret_key" \
-F "[email protected]" \
-F "partition=marketing" \
-F "collection=blog" \
-F "channel=hero-images"The response includes the asset metadata:
{
"id": "asset_01abc...",
"vault_id": "vault_01abc...",
"partition": "marketing",
"collection": "blog",
"channel": "hero-images",
"filename": "photo.jpg",
"size": 245760,
"mime_type": "image/jpeg",
"created_at": "2026-01-15T10:30:00Z"
}3. Deliver the Image
Access your image via the delivery URL:
https://your-vault.imgbt.com/marketing/blog/hero-images/photo.jpg4. Apply Transforms
Add query parameters to transform on the fly:
https://your-vault.imgbt.com/marketing/blog/hero-images/photo.jpg?w=800&h=600&fit=cover&format=webp&q=85This resizes to 800x600, covers the area, converts to WebP, and sets quality to 85.
Next Steps
- Authentication — Learn about API keys and session auth
- API Reference — Full endpoint documentation
- Transform Parameters — All available transforms