Skip to main content

​
Create Your Account

  1. Visit app.imperial.gay
  2. Sign up with your email and create a password
  3. Verify your email address

​
Get Your API Key

Upload Key Only
  1. Navigate to Settings → Security
  2. Copy your upload key (starts with imperial_upload_)
  3. Use this key for uploading images and videos
Free and Starter tiers have upload-only keys. Upgrade to Pro for full API access.
Your keys start with imperial_upload_ (upload key) or imperial_live_ (API key) and provide access to your account. Never share them publicly or commit them to version control.

​
Upload Your First Image

Use this simple cURL command to upload an image: 
curl -X POST https://api.imperial.gay/images/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your/image.jpg"
Replace YOUR_API_KEY with your actual API key and update the file path.

​
Response

{
  "_id": "67d8f9a1b2c3d4e5f6789012",
  "url": "https://cdn.imperial.gay/uploads/user-id/upload-id-image.jpg",
  "filename": "upload-id-image.jpg",
  "fileSize": 245678,
  "mimeType": "image/jpeg",
  "createdAt": "2026-01-07T12:34:56.789Z"
}

​
Upload a Video

Imperial supports video uploads too! Just change the file type: 
curl -X POST https://api.imperial.gay/images/upload \
  -H "Authorization: Bearer YOUR_KEY_HERE" \
  -F "file=@/path/to/your/video.mp4"
Videos automatically generate thumbnails for faster gallery loading.

​
What’s Next?

API Reference

Explore all available endpoints

Dashboard

View your uploads in the dashboard

​
Features

  • Zero Egress Fees - Unlimited bandwidth powered by Cloudflare R2
  • Auto Compression - Optionally compress images to save storage
  • Video Support - Upload and host videos with automatic thumbnails
  • Fast CDN - Global content delivery for instant loading
  • Storage Tiers - Flexible plans from 5GB to 200GB