Developer API Reference
Powerful, simple, and lightning-fast image hosting for your applications. Convert binary data to permanent URLs in milliseconds.
Getting Started
The ImageToURL API is organized around REST. Our API has predictable resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
Base URL Production
https://api.imagetourl.cloud/v1 Authentication
The ImageToURL API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard. Your API keys carry many privileges, so be sure to keep them secure!
curl https://api.imagetourl.cloud/v1/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/my_image.png" Upload an Image
POST
/upload Upload an image file directly to our secure servers and receive a permanent, CDN-cached URL.
Parameters
| Name | Type | Description |
|---|---|---|
| file | binary | The image file (PNG, JPG, WebP) up to 10MB. |
| ttl | integer | Optional time to live in seconds. |
| folder | string | Destination folder name. |
Response Example 200 OK
{
"status": "success",
"data": {
"id": "img_98234",
"url": "https://cdn.imagetourl.cloud/a98x.png",
"size": 102488,
"mimetype": "image/png",
"created_at": "2023-10-27T10:00:00Z"
}
}