开发者 API参考
为您的应用提供强大、简单且闪电般快速的图片托管。在毫秒内将二进制数据转换为永久URL。
快速入门
ImageToURL API基于REST架构。我们的API具有可预测的面向资源的URL,返回JSON编码的响应,并使用标准HTTP响应代码、身份验证和方法。
基础URL 生产环境
https://api.imagetourl.cloud/v1 身份验证
ImageToURL API使用API密钥进行请求身份验证。您可以在控制面板中查看和管理API密钥。API密钥拥有很多权限,请确保妥善保管!
curl https://api.imagetourl.cloud/v1/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/my_image.png" 上传图片
POST
/upload 直接将图片文件上传到我们的安全服务器,获取永久的CDN缓存URL。
参数
| 名称 | 类型 | 描述 |
|---|---|---|
| file | binary | 图片文件(PNG、JPG、WebP),最大10MB。 |
| ttl | integer | 可选的存活时间(秒)。 |
| folder | string | 目标文件夹名称。 |
响应示例 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"
}
}