开发者 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" } }