圖床服務

圖片外鏈託管：上傳圖片（或 ≤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

鑑權設置

僅本機保存