图床服务

图片外链托管：上传图片（或 ≤10 秒短视频）返回可直链访问的 CDN 地址，支持输出格式、加密与存储位置选择。当前接入 2 条线路。

/api/ImageHosting/

服务说明

图床服务把图片上传到第三方托管平台并返回可直接引用的 CDN 外链，适合做站点配图、Markdown 图床、用户头像托管等场景，省去自建存储与带宽。

scdn 线路支持上传本地图片或传入远程图片 URL，服务端按内容 SHA-256 秒传——同一张图片重复上传会直接返回已有链接，不会额外占用容量；picui 线路附带服务端 Token 池管理，可查看各 Token 的已用与剩余容量，并支持批量补充 Token。

两条线路均需项目签名。第三方图床的链接可用性由对方平台决定，重要图片建议自行留存原图。

响应格式

所有接口返回同一个 JSON 信封，业务数据都在 data 里：

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}

code：业务状态码，10000 表示成功；其余为各类错误，完整清单见「错误码」页。
msg：给人看的提示文案，可直接展示给终端用户，但不要用它做逻辑判断。
data：业务数据；出错时通常为 null。各接口 data 的具体字段见该接口的「响应说明」。

判断成功与否请看 code，不要依赖 HTTP 状态码。查看完整错误码

维护中该服务当前处于「维护中」状态，接口可能临时不可用。以下文档与调试仅供了解。

scdn.io 图床

scdn.io（img.scdn.io）图片托管需签名

上传图片返回外链；服务端按 SHA-256 秒传，重复图片直接返回已有链接。需项目签名调用。

POST /api/ImageHosting/scdn/upload 累计调用 0 次

上传图片

上传一张图片，返回可直接引用的 CDN 外链。

图片文件 image

本地图片文件（multipart 字段 image，支持 jpg/png/webp/gif/bmp/tiff）；与 image_url 二选一

远程图片 URL image_url

远程图片地址（http/https），服务端代理拉取；与 image 二选一

输出格式 output_format

选填：输出格式，默认 auto

CDN 域名 cdn_domain

选填：指定外链 CDN 域名（如 img.scdn.io），留空自动选择

存储位置 storage_destination

选填：存储位置

启用密码 password_enabled

选填：加密上传（加密图永不参与秒传）

访问密码 image_password

选填：password_enabled=true 时必填

密码模式 password_type

选填：密码模式，默认 plain

问题文本 password_question

选填：password_type=qa 时必填

请求体为 multipart/form-data（文件字段 image，可直接用下方“选择文件”上传）；用 image_url 时也可用 application/x-www-form-urlencoded。
服务端按 SHA-256 秒传：命中时 message 为「图片已存在，秒传成功！」，deduped=true。
本服务需项目签名（app_id/timestamp/nonce/sign）；在线调试由服务端自动代签。

响应说明外层统一格式

字段	类型	说明
url	string	CDN 外链地址
filename	string	文件名
storage_backend	string	存储后端
original_size	int	原始大小（字节）
compressed_size	int	压缩后大小（字节）
compression_ratio	float	压缩率
deduped	bool	是否命中秒传
password_protected	bool	是否加密保护

返回示例

{"url": "https://img.scdn.io/xxxx.jpg", "filename": "xxxx.jpg", "storage_backend": "local", "original_size": 123456, "compressed_size": 98765, "compression_ratio": 80.01, "deduped": false, "password_protected": false}

PicUI 图床

PicUI（v2.picui.cn）图片托管需签名

上传图片返回外链；PicUI 账号 Token 由服务端 Token 池统一持有并记账，容量用尽自动切换，调用方无需提供账号。需项目签名调用。

POST /api/ImageHosting/picui/upload 累计调用 0 次

上传图片

上传一张图片，返回可直接引用的外链地址（含 html / markdown 等多种引用格式）。

图片文件 image *

本地图片文件（multipart 字段 image），必需

图片权限 permission

选填：图片权限，留空使用 PicUI 默认值

储存策略ID strategy_id

选填：PicUI 储存策略 ID，默认 1（「普通用户」策略）

相册ID album_id

选填：目标相册 ID

过期时间 expired_at

选填：图片过期时间，格式 yyyy-MM-dd HH:mm:ss

临时上传Token upload_token

选填：PicUI 临时上传 Token（对应其 token 字段），一般不传

请求体为 multipart/form-data（文件字段 image，可直接用下方“选择文件”上传）。
PicUI 账号 Token 由服务端 Token 池自动选取，调用方无需（也无法）指定；上传成功后按 PicUI 返回的图片大小扣减该 Token 容量，容量用尽自动删除并切换下一个。
令牌池告警：上传后若池内剩余容量跌破 50MB，系统会自动向管理员邮箱（环境变量 QQ_MAIL_ACCOUNT，未配置则不发送）发送一封补货提醒邮件；该告警只在「跌破」的那一次发送，补货回到 50MB 以上后再次跌破才会重新告警。
Token 池为空或容量均已用尽时返回 50002，请先调用「导入 Token」接口补充。
本服务需项目签名（app_id/timestamp/nonce/sign）；在线调试由服务端自动代签。

响应说明外层统一格式

字段	类型	说明
url	string	图片外链地址
name	string	文件名
pathname	string	存储路径
origin_name	string	原始文件名
size_kb	int	文件大小（KB）
size_bytes	int	文件大小（字节）
mimetype	string	MIME 类型
extension	string	扩展名
md5	string	MD5 值
sha1	string	SHA-1 值
links	object	多种引用格式
links.html	string	HTML 引用
links.bbcode	string	论坛 BBCode 引用
links.markdown	string	Markdown 图片
links.markdown_with_link	string	带链接的 Markdown
links.thumbnail_url	string	缩略图地址

返回示例

{"url": "https://v2.picui.cn/i/2026/07/01/xxxx.jpg", "name": "xxxx.jpg", "pathname": "/i/2026/07/01/xxxx.jpg", "origin_name": "photo.jpg", "size_kb": 120, "size_bytes": 122880, "mimetype": "image/jpeg", "extension": "jpg", "md5": "0f3d2c1b4a5968778695a4b3c2d1e0f1", "sha1": "0f3d2c1b4a5968778695a4b3c2d1e0f1a2b3c4d", "links": {"html": "<img src=\"https://v2.picui.cn/i/2026/07/01/xxxx.jpg\">", "bbcode": "[img]https://v2.picui.cn/i/2026/07/01/xxxx.jpg[/img]", "markdown": "![xxxx.jpg](https://v2.picui.cn/i/2026/07/01/xxxx.jpg)", "markdown_with_link": "[![xxxx.jpg](https://v2.picui.cn/i/2026/07/01/xxxx.jpg)](https://v2.picui.cn/i/2026/07/01/xxxx.jpg)", "thumbnail_url": "https://v2.picui.cn/i/2026/07/01/xxxx.jpg"}}

GET /api/ImageHosting/picui/tokens 累计调用 0 次

查询 Token 池

查看 Token 池整体容量与每个 Token 的已用 / 剩余容量（Token 已脱敏）。

容量同时提供 MB（保留 2 位小数，便于阅读）与字节（便于计算）两种单位。
容量用尽（已用 ≥ 容量）的 Token 会被自动删除，因此 items 中出现的 Token 均可继续使用；服务器只做容量记账，不参与图片存储。

响应说明外层统一格式

字段	类型	说明
count	int	池内可用 Token 数量
total_capacity_mb	float	总容量合计（MB）
total_capacity_bytes	int	总容量合计（字节）
total_used_mb	float	已用容量合计（MB）
total_used_bytes	int	已用容量合计（字节）
total_remaining_mb	float	剩余容量合计（MB，看它判断补货）
total_remaining_bytes	int	剩余容量合计（字节）
items	array	每个 Token 的容量明细
items[].token	string	Token 脱敏值（留首 6 末 4）
items[].capacity_mb	float	该 Token 总容量（MB）
items[].capacity_bytes	int	该 Token 总容量（字节）
items[].used_mb	float	该 Token 已用（MB）
items[].used_bytes	int	该 Token 已用（字节）
items[].remaining_mb	float	该 Token 剩余（MB）
items[].remaining_bytes	int	该 Token 剩余（字节）
items[].create_time	string	该 Token 的入库时间

返回示例

{"count": 1, "total_capacity_mb": 50.0, "total_capacity_bytes": 52428800, "total_used_mb": 12.34, "total_used_bytes": 12942336, "total_remaining_mb": 37.66, "total_remaining_bytes": 39486464, "items": [{"token": "657|uN****afdb", "capacity_mb": 50.0, "capacity_bytes": 52428800, "used_mb": 12.34, "used_bytes": 12942336, "remaining_mb": 37.66, "remaining_bytes": 39486464, "create_time": "2026-09-01 10:00:00"}]}

POST /api/ImageHosting/picui/tokens 累计调用 0 次

导入 Token

向 Token 池新增一个或多个 Token（支持直接输入，也支持上传按行存放的 Token 文件）。

Token tokens

选填：待新增的 Token，可多个（与 token_file 至少传一项）

多值写法：可重复传参，或用逗号、换行分隔一次提交多个

Token 文件 token_file

选填：文本文件，按行存放 Token（一行一个，UTF-8）

单个容量(MB) capacity_mb

选填：每个 Token 的容量（MB），默认 50

Token 唯一：同一个 Token 只会入库一条，重复导入不会重复写入（库中已存在、或同一批请求里重复出现的，都计入 duplicated 跳过）。
tokens 支持重复字段、逗号或换行分隔，一次可提交多个 Token；Token 内不能含空格等空白字符（文件里若带注释/多余列会被拒绝，避免导入无效 Token）。
token_file 为按行存放 Token 的文本文件（一行一个），可与 tokens 同时使用。
单次最多导入 1000 个 Token；本服务需项目签名（app_id/timestamp/nonce/sign）。

响应说明外层统一格式

字段	类型	说明
submitted	int	本次提交的 Token 数（去重后）
created	int	实际新增数量
duplicated	int	因已存在而跳过的数量
duplicated_tokens	array	被跳过的 Token 脱敏列表
capacity_bytes	int	每个新 Token 的容量（字节）
capacity_mb	float	每个新 Token 的容量（MB）

返回示例

{"submitted": 3, "created": 2, "duplicated": 1, "duplicated_tokens": ["657|uN****afdb"], "capacity_bytes": 52428800, "capacity_mb": 50.0}

接口目录 4

scdn.io 图床

POST 上传图片 /api/ImageHosting/scdn/upload

PicUI 图床

POST 上传图片 /api/ImageHosting/picui/upload GET 查询 Token 池 /api/ImageHosting/picui/tokens POST 导入 Token /api/ImageHosting/picui/tokens

鉴权设置

仅本机保存