点击或拖拽上传图片
支持 JPG、JPEG、PNG、GIF、WebP、AVIF 等格式，最大 100MB
💡 你也可以直接 Ctrl+V 粘贴剪贴板中的图片
图片处理设置
配置您的图片上传和处理偏好
图片处理
95
高质量
水印设置
便捷功能
天
历史上传
全选
API 接口
API 密钥
API 文档
认证方式
所有需要认证的接口均通过请求头传递 API 密钥：
-H "X-API-Key: 您的API密钥"
限制：每分钟最多 10 次上传，每日最多 200 张，单文件最大 100MB，支持 JPG / PNG / GIF / WebP。
1. 上传图片
POST /api/upload上传图片文件，返回直链及多种格式链接
请求参数（multipart/form-data）:
成功响应：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
image | File | 是 | 图片文件 |
compressToWebp | String | 否 | 是否压缩转 WebP，默认 "true" |
webpQuality | Number | 否 | 压缩质量 10-100，默认 90 |
autoWatermark | String | 否 | 是否添加水印，默认 "false" |
watermarkContent | String | 否 | 水印文字 |
autoDelete | String | 否 | 是否自动删除，默认 "false" |
deleteDays | Number | 否 | 自动删除天数，默认 30 |
{
"id": "abc123",
"url": "https://example.com/uploads/2025/06/abc123.webp",
"thumbUrl": "https://example.com/uploads/thumbs/2025/06/abc123_thumb.webp",
"size": 102400,
"width": 800,
"height": 600,
"format": "webp",
"markdown": "",
"html": "<img src=\"https://example.com/uploads/2025/06/abc123.webp\" alt=\"image\" />",
"bbcode": "[img]https://example.com/uploads/2025/06/abc123.webp[/img]"
}
cURL 示例：
curl -X POST "https://example.com/api/upload" \ -H "X-API-Key: 您的API密钥" \ -F "image=@/path/to/your/image.jpg"
2. 获取图片列表
GET /api/v1/list分页获取当前用户的图片列表
查询参数:
成功响应：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | Number | 否 | 页码，默认 1 |
limit | Number | 否 | 每页数量，默认 50，最大 100 |
{
"items": [
{
"id": "abc123",
"url": "https://example.com/uploads/2025/06/abc123.webp",
"thumbUrl": "https://example.com/uploads/thumbs/2025/06/abc123_thumb.webp",
"size": 102400,
"width": 800,
"height": 600,
"createdAt": 1717400000000
}
],
"total": 128,
"totalPages": 3,
"currentPage": 1
}
cURL 示例：
curl -X GET "https://example.com/api/v1/list?page=1&limit=50" \ -H "X-API-Key: 您的API密钥"
3. 删除单张图片
DELETE /api/v1/delete/{id}删除指定 ID 的图片（仅限自己的图片）
路径参数:
成功响应：
| 字段 | 类型 | 说明 |
|---|---|---|
id | String | 图片 ID |
{ "message": "删除成功" }
cURL 示例：
curl -X DELETE "https://example.com/api/v1/delete/abc123" \ -H "X-API-Key: 您的API密钥"
4. 批量删除图片
POST /api/images/delete批量删除多张图片（仅限自己的图片）
请求体（JSON）:
成功响应：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
ids | String[] | 是 | 图片 ID 数组 |
{ "message": "删除完成" }
cURL 示例：
curl -X POST "https://example.com/api/images/delete" \
-H "X-API-Key: 您的API密钥" \
-H "Content-Type: application/json" \
-d '{"ids":["abc123","def456"]}'
5. 获取统计信息
GET /api/stats获取图床全局统计数据（无需认证）
成功响应：
{
"total": 1234,
"today": 56,
"totalSize": 1073741824
}
cURL 示例：
curl "https://example.com/api/stats"
上传中...