API Documentation
Fast, secure image hosting API with comprehensive documentation. Get started in minutes.
RapidAPI Endpoint
https://upload-images-hosting-get-url.p.rapidapi.com/upload
Base URL
https://upload-images-hosting-get-url.p.rapidapi.com
Authentication
Header: x-rapidapi-key
Overview
Your go-to ultra-fast image hosting API. Upload, fetch, and delete images via a single endpoint.
What This API Can Do
- • Upload images (file, base64, remote URL, data URI)
- • Retrieve direct image URLs
- • Delete images via secure delete link
- • Automatic caching for fast delivery
- • Optional expiration for auto-delete
Authentication
To authenticate, users must include the x-rapidapi-key header with your RapidAPI key. This is required for all requests to the API.
Upload Images
Upload images in multiple formats - file, base64, remote URL, data URI, or self-URLs.
Supported Formats
Input Types
- • File Upload (multipart)
- • Base64 String
- • Data URI
- • Remote URL
Image Types
- • PNG, JPEG, WEBP
- • GIF, SVG, AVIF
- • Auto-detected MIME
Required Fields
| Field | Type | Description |
|---|---|---|
| image | File/String | Image data (required) |
| name | String | Custom filename (optional) |
| expiration | Number | Seconds or Unix timestamp (optional) |
Delete Images
Use the delete_url returned in the upload response to permanently remove files from storage.
Rate Limits
Rate limits are based on your plan on RapidAPI.
Code Examples
Upload via File (multipart/form-data)
curl -X POST https://upload-images-hosting-get-url.p.rapidapi.com/upload \
-H "x-rapidapi-key: YOUR_API_KEY" \
-F "image=@/path/to/image.jpg" \
-F "name=my-image" \
-F "expiration=0"Upload via URL (JSON)
curl -X POST https://upload-images-hosting-get-url.p.rapidapi.com/upload \
-H "x-rapidapi-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "https://example.com/image.jpg",
"name": "remote-image",
"expiration": 0
}'JavaScript/Node.js
const formData = new FormData();
formData.append('image', imageFile);
formData.append('name', 'my-image');
formData.append('expiration', '0');
const response = await fetch(
'https://upload-images-hosting-get-url.p.rapidapi.com/upload',
{
method: 'POST',
headers: {
'x-rapidapi-key': 'YOUR_API_KEY'
},
body: formData
}
);
const data = await response.json();
console.log(data.data.url);Response Format
{
"success": true,
"status": 200,
"data": {
"id": "abc123",
"title": "my-image",
"url": "https://i.dishis.tech/i/abc123",
"display_url": "https://i.api.dishis.tech/i/abc123",
"width": "1920",
"height": "1080",
"size": "524288",
"delete_url": "https://i.api.dishis.tech/delete/abc123/token",
"expiration": "0"
}
}Error Responses
Error 400
Invalid request or missing image field
Error 401
Unauthorized - missing or invalid API key
Error 413
File size exceeds limit for your plan
Error 429
Rate limit exceeded
Error 500
Server error - please try again
Ready to Integrate?
Get your API key from RapidAPI and start uploading images programmatically.
Get API Key