Skip to main content
REST API v1

Geliştiriciler İçin Ücretsiz Resim Yükleme API'si

Tek bir HTTP POST isteğiyle web veya mobil uygulamalarınıza hızlı resim yükleme entegre edin.

View Code Examples Full API Documentation Interactive Web Uploader
POST https://imageupload.app/api/1/upload
Content-Type: multipart/form-data

Upload up to 5 images per request, up to 32MB per file. Returns instant direct CDN URLs, deletion tokens, and thumbnail links in standard JSON.

Quickstart Code Examples

bash 
# Basic upload using cURL
curl -X POST "https://imageupload.app/api/1/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "images=@/path/to/your/screenshot.png"
javascript 
const formData = new FormData();
formData.append('images', fileInputElement.files[0]);

const response = await fetch('https://imageupload.app/api/1/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
});

const data = await response.json();
console.log('Direct image URL:', data.images[0].directUrl);
python 
import requests

url = "https://imageupload.app/api/1/upload"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
files = {"images": open("photo.jpg", "rb")}

response = requests.post(url, headers=headers, files=files)
result = response.json()

print("Direct URL:", result["images"][0]["directUrl"])
json (200 OK) 
{
  "success": true,
  "images": [
    {
      "name": "a1b2c3d4e5f678901234.png",
      "directUrl": "https://imageupload.app/uploads/a1b2c3d4e5f678901234.png",
      "thumbnailUrl": "https://imageupload.app/uploads/thumb_a1b2c3d4e5f678901234.png",
      "deleteUrl": "https://imageupload.app/delete/a1b2c3d4e5f678901234?token=del_xyz789",
      "size": 145020,
      "mimeType": "image/png",
      "width": 1920,
      "height": 1080
    }
  ]
}

Built for Developer Workflows

High-Speed Global CDN

Every uploaded image is distributed across global edge nodes for ultra-low latency direct asset delivery.

Private & Expirable Uploads

Set custom storage lifetimes (from 1 minute to 1 year) or pass unlisted visibility parameters directly in the API call.

Native Vector & Animated Support

Full support for PNG, JPEG, WebP, SVG (served as image/svg+xml), GIF animations, and HEIC camera assets.

API Request Parameters

Field Type Required Description
images File / Multi Yes One or more binary image files. Maximum 5 files per request. Up to 32MB per file.
key String Conditional API Token. Can be passed in body, query (?key=...), or HTTP header (Authorization: Bearer KEY).
storageDuration String Optional Retention duration: unlimited, 1_minute, 5_minutes, 1_hour, 1_day, 1_week, 1_month, 1_year.
visibility String Optional Image access mode: public, unlisted, or private. Default is public.

Frequently Asked Questions

Yes. Free tier accounts can upload images programmatically with zero charge. Generous monthly quotas are provided out of the box, with instant direct link generation.

Sign in to your account and visit the Account Settings tab. You can generate, inspect, and revoke your API tokens at any time.

Yes. Every successful upload returns a unique deleteUrl containing a secure cryptographic deletion token. Making an HTTP request to this URL immediately purges the image.

Yes. The API endpoints provide permissive CORS headers (Access-Control-Allow-Origin: *), enabling direct uploads from browser client-side SPAs and mobile webviews.