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 SettingsSecurity
  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?

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