图床 API - Yn

图床 API

图床 API 套餐

免费版

免费

100 次/天

图片上传接口
HTTPS 直链访问
支持 PNG/JPG/WebP/GIF

专业版

¥29/月

不限次数

不限调用次数
HTTPS 直链访问
优先响应
技术支持

购买后联系管理员开通 API Key

图床 API 需要 API Key

在请求 Header 中携带 X-API-Key 即可调用。API Key 通过 POST /api/image/keys/create 创建。

POST/api/image/upload

上传图片并获取 HTTPS 直链，支持 PNG/JPG/WebP/GIF/BMP，单张最大 50MB

Header: X-API-Key: yn_img_xxxxx
Content-Type: multipart/form-data
Body: file (File) - 图片文件

Response: { "ok": true, "url": "https://img.yntech.xyz/files/xxxx.webp" }

GET/api/image/usage

查询当前 API Key 的使用量和配额

Header: X-API-Key: yn_img_xxxxx

Response: {
 "ok": true,
 "tier": "free",
 "todayUsage": 12,
 "dailyQuota": 100,
 "remaining": 88
}

POST/api/image/keys/create

创建一个新的 API Key，免费版每日限额 100 次

Header: Authorization: Bearer <jwt_token>
Content-Type: application/json
Body: { "name": "my-key", "tier": "free" }

Response: { "ok": true, "key": "yn_img_xxxxx", "tier": "free", "daily_quota": 100 }

GET/api/image/keys

列出当前账号下所有 API Key

Header: Authorization: Bearer <jwt_token>

Response: {
 "ok": true,
 "keys": [
 { "id": 1, "name": "my-key", "key": "yn_img_***", "tier": "free", "todayUsage": 5, "daily_quota": 100 }
 ]
}

POST/api/image/keys/:id/delete

删除指定的 API Key

Header: Authorization: Bearer <jwt_token>

Response: { "ok": true }

GET/api/image/pricing

获取所有 API 套餐及价格信息

Response: {
 "tiers": [
 { "id": "free", "name": "免费版", "price": "免费", "dailyQuota": 100 },
 { "id": "pro", "name": "专业版", "price": "¥29/月", "dailyQuota": -1 }
 ]
}