API v2 开放接口文档

v2.0 RESTful
兔兔图床提供强大的高并发 RESTful API v2，支持文件流上传、远程 URL 抓取上传以及图片信息检索。开发者可通过简短的 HTTP 请求快速集成图床能力。
获取我的 API Key

认证与鉴权 (Authentication)

所有 API 请求均需要在参数中携带 API Key，通过按键关联后的上传图片会自动归属到您的个人账户，享有相册归档与永久保存权益。
POST
/api/2/upload
— 文件流上传接口
multipart/form-data
支持二进制文件流或 base64 格式上传图片，单图最大支持 30MB。
请求参数表：
  • key (必需): 您的 API Key（UUID v4 格式）。
  • source (必需): 图片文件流 (multipart File)、Base64 编码字符串或远程 URL。
cURL 示例
curl -X POST "https://tutu.to/api/2/upload" \
  -F "key=YOUR_API_KEY" \
  -F "source=@/path/to/image.png"
POST
/api/2/urlUpload
— 远程 URL 抓取上传
multipart/form-data
通过远程图片 URL 直接拉取并保存到兔兔图床 CDN 数据平面，免去本地下载再上传的繁琐步骤。
cURL 示例
curl -X POST "https://tutu.to/api/2/urlUpload" \
  -F "key=YOUR_API_KEY" \
  -F "imgUrl=https://example.com/image.png"

标准 JSON 响应结构

成功响应包含图片元数据与查看页链接。chain 字段的 bit0=缩略图、bit1=中图，表示已生成的缓存尺寸。
Response 200 OK
{
  "status_code": 200,
  "success": {
    "message": "image uploaded",
    "code": 200
  },
  "image": {
    "name": "example",
    "extension": "png",
    "width": 1920,
    "height": 1080,
    "url_viewer": "https://tutu.to/image/example.abc123",
    "chain": 3
  }
}

错误码参考

错误码HTTP 状态说明
230400API Key 无效或缺失
250429API 调用频率超出限制（每分钟 30 次）
130400上传来源为空或 URL 拉取失败
500500服务器内部错误
错误响应格式：{"status_code": 400, "error": {"message": "...", "code": 230}}