自建图床API
图像提交上传 API 帮助文档
接口概述
本服务可用来上传图像文件文件资源到服务器，全面支持多种图像数据格式的提交上传。
接口详情
发起请求信息
请求URL: https://imageproxy.zhongzhuan.chat/api/upload
请求方法: POST
Content-Type: multipart/form-data
请求参数项
| 请求参数名 | 类别 | 必须传入 | 详细说明 |
|---|---|---|---|
| file | File | 是 | 要提交上传的图像文件资源 |
请求代码示例
cURL 代码示例
curl -X POST \ https://imageproxy.zhongzhuan.chat/api/upload \ -H 'Content-Type: multipart/form-data' \ -F 'file=@/path/to/your/image.jpg'JavaScript 代码示例
const formData = new FormData(); formData.append('file', fileInput.files[0]); fetch('https://imageproxy.zhongzhuan.chat/api/upload', { method: 'POST', body: formData }) .then(response => response.json()) .then(data => { console.log('上传成功:', data); }) .catch(error => { console.error('上传失败:', error); });Python 代码示例
import requests url = "https://imageproxy.zhongzhuan.chat/api/upload" files = {'file': open('image.jpg', 'rb')} response = requests.post(url, files=files) print(response.json())响应数据信息
成功响应数据
HTTP 状态码: 200 OK
响应格式: JSON
| 配置项名 | 类别 | 详细说明 |
|---|---|---|
| url | String | 提交上传成功后的图像前往访问链接 |
| created | Number | 创建生成时间戳（毫秒） |
响应数据示例
{ "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/2316ce07a01000cf14a628c8b29e97a8", "created": 1757403998946 }错误响应数据
可能的错误状态码：
| 状态码 | 详细说明 |
|---|---|
| 400 | 请求参数项错误（如：未对外提供文件资源） |
| 413 | 文件资源过大 |
| 415 | 不全面支持的文件资源数据格式 |
| 500 | 服务器内部错误 |
错误响应数据示例
{ "error": "文件格式不支持", "code": 415 }使用详细说明
- 支持的文件格式: 常见图像数据格式如 JPG、PNG、GIF、WebP 等
- 文件大小限制: 推荐单个文件资源不超过 10MB
- 返回的 URL: 可直接可用来显示图像，链接长期有效
- 时间戳格式: Unix 时间戳，单位为毫秒
温馨提示事项
- 提交上传的图像会通过代理服务进行处理，确保前往访问高可用性稳定性
- 推荐在客户端对图像进行适当压缩以提高提交上传速度
- 输出的图像链接全面支持跨域前往访问
- 提交上传前请确保有网络连接和适当的权限