# ImgBox

> 免注册文件上传与分享服务。图片、视频、音频与 PDF，水印与压缩在浏览器内完成，
> 返回可直接粘贴进论坛的 BBCode。

## 开始使用

* [使用文档](https://imgly.net/docs)：网页上传、匿名身份、删除、备份恢复
* [AI BBCode 排版](https://imgly.net/ai)：把文本整理成论坛可粘贴的 BBCode
* [OpenAPI 规范](https://imgly.net/openapi.yaml)：完整的机器可读接口定义
* [API 目录](https://imgly.net/.well-known/api-catalog)：按功能分组的接口索引

## 给 Agent 的接入点

* [上传](https://imgly.net/.well-known/agent-skills/imgbox-upload.md)：可运行的 curl 示例
* [身份](https://imgly.net/.well-known/agent-skills/imgbox-identity.md)：X-User-Token 与身份文件
* [删除](https://imgly.net/.well-known/agent-skills/imgbox-delete.md)：DELETE /api/v1/delete
* [认证说明](https://imgly.net/auth.md)：匿名优先，公开上传不需要 OAuth
* [MCP Server Card](https://imgly.net/.well-known/mcp/server-card.json)：浏览器侧 WebMCP 工具
* [Agent Skills 索引](https://imgly.net/.well-known/agent-skills/index.json)：带 sha256 的技能清单

## 两条必须先知道的规则

1. **身份文件就是删除钥匙。** 它同时掌管上传历史与删除权，没有轮换、没有吊销。
   当作密码保管，不要放进对话、截图、日志或仓库。
2. **删除不可逆。** 调用删除接口前必须向用户确认，并点名具体文件。

## 备注

* 大文件请走 Tus（`POST https://imgly.net/api/tus/files`）：断线可续传，普通
  multipart 不行。
* 视频的 `play_url` 要等转码完成才出现，上传后 `variants_pending` 为 true
  时可能还没有。
* 入口有限速，突发请求会收到 429，客户端应退避重试而不是立即重投。

联系：imgly@proton.me