Navigation
Features How It Works API Endpoints Code Examples
API Documentation — v1.0

Image Hosting
Simplified.

A fast, serverless image upload API built on Workers. Upload, manage, and deliver your images globally in milliseconds.

View API Docs
99.9%
Uptime SLA
<50ms
Response Time
Unlimited
Bandwidth

Built for Performance

Everything you need to host and deliver images for your applications securely and efficiently.

Global CDN

Images are cached and served from the nearest edge node globally, ensuring blazing fast load times.

Secure Authentication

Protect your uploads with API Key authentication via custom headers. You control who can upload or delete media.

Simple REST API

Clean, predictable endpoints. Integrate into Node, Python, PHP, or frontend frameworks in minutes.

How It Works

Upload an image and get a global CDN link in three simple steps.

1

Authenticate

Include your unique API key in the X-API-Key header of your HTTP request to verify your identity.

2

Send Request

Make a POST request to /upload with your image file attached as multipart form-data.

3

Receive CDN Link

Instantly receive a JSON response containing the direct, globally distributed url for your image.

API Endpoints

Base URL: https://host.orange-print-tools.workers.dev

POST
/upload
GET
/img/{id}
DELETE
/delete/{id}
GET
/api/key-stats
Authentication Required All endpoints (except serving images) require a valid API key sent via the X-API-Key header or Bearer token.

Code Examples

Ready-to-use snippets for your backend or frontend.

Python (requests)

Python
import requests

url = "https://host.orange-print-tools.workers.dev/upload"
key = "your_api_key"

with open("image.jpg", "rb") as f:
    r = requests.post(url,
        headers={"X-API-Key": key},
        files={"file": f}
    )
# r.json() contains: { "success": true, "url": "...", "id": "..." }
print(r.json())

JavaScript (fetch)

JavaScript
const form = new FormData();
form.append('file', fileInput.files[0]);

const res = await fetch(`https://host.orange-print-tools.workers.dev/upload`, {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' },
  body: form
});
const data = await res.json();
console.log(data.url); // CDN URL