圖床服務

圖片外鏈託管：上傳圖片（或 ≤10 秒短視頻）返回可直鏈訪問的 CDN 地址，支持輸出格式、加密與存儲位置選擇。當前接入 2 條線路。

/api/ImageHosting/

服務說明

圖床服務把圖片上傳到第三方託管平臺並返回可直接引用的 CDN 外鏈，適合做站點配圖、Markdown 圖床、用戶頭像託管等場景，省去自建存儲與帶寬。

scdn 線路支持上傳本地圖片或傳入遠程圖片 URL，服務端按內容 SHA-256 秒傳——同一張圖片重複上傳會直接返回已有鏈接，不會額外佔用容量；picui 線路附帶服務端 Token 池管理，可查看各 Token 的已用與剩餘容量，並支持批量補充 Token。

兩條線路均需項目簽名。第三方圖床的鏈接可用性由對方平臺決定，重要圖片建議自行留存原圖。

scdn.io 圖床

scdn.io（img.scdn.io）圖片託管需簽名

上傳圖片返回外鏈；服務端按 SHA-256 秒傳，重複圖片直接返回已有鏈接。需項目簽名調用。

POST /api/ImageHosting/scdn/upload 累計調用 0 次

上傳圖片

上傳一張圖片，返回可直接引用的 CDN 外鏈。

圖片文件

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

遠程圖片 URL

遠程圖片地址（http/https），服務端代理拉取；與 image 二選一

輸出格式

選填：輸出格式，默認 auto

CDN 域名

選填：指定外鏈 CDN 域名（如 img.scdn.io），留空自動選擇

存儲位置

選填：存儲位置

啟用密碼

選填：加密上傳（加密圖永不參與秒傳）

訪問密碼

選填：password_enabled=true 時必填

密碼模式

選填：密碼模式，默認 plain

問題文本

選填：password_type=qa 時必填

請求體為 multipart/form-data（文件字段 image，可直接用下方「選擇文件」上傳）；用 image_url 時也可用 application/x-www-form-urlencoded。
返回 data 含 url / filename / storage_backend / 壓縮統計 / deduped（是否秒傳） / password_protected。
服務端按 SHA-256 秒傳：命中時 message 為「圖片已存在，秒傳成功！」，deduped=true。
本服務需項目簽名（app_id/timestamp/nonce/sign）；在線調試由服務端自動代簽。

PicUI 圖床

PicUI（v2.picui.cn）圖片託管需簽名

上傳圖片返回外鏈；PicUI 賬號 Token 由服務端 Token 池統一持有並記賬，容量用儘自動切換，調用方無需提供賬號。需項目簽名調用。

POST /api/ImageHosting/picui/upload 累計調用 1 次

上傳圖片

上傳一張圖片，返回可直接引用的外鏈地址（含 html / markdown 等多種引用格式）。

圖片文件 *

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

圖片權限

選填：圖片權限，留空使用 PicUI 默認值

儲存策略ID

選填：PicUI 儲存策略 ID，默認 1（「普通用戶」策略）

相冊ID

選填：目標相冊 ID

過期時間

選填：圖片過期時間，格式 yyyy-MM-dd HH:mm:ss

臨時上傳Token

選填：PicUI 臨時上傳 Token（對應其 token 字段），一般不傳

請求體為 multipart/form-data（文件字段 image，可直接用下方「選擇文件」上傳）。
PicUI 賬號 Token 由服務端 Token 池自動選取，調用方無需（也無法）指定；上傳成功後按 PicUI 返回的圖片大小扣減該 Token 容量，容量用儘自動刪除並切換下一個。
返回 data 含 url / size_kb / size_bytes / mimetype / extension / md5 / sha1 / links（html、bbcode、markdown、markdown_with_link、thumbnail_url 等）。
令牌池告警：上傳後若池內剩餘容量跌破 50MB，系統會自動向管理員郵箱（環境變量 QQ_MAIL_ACCOUNT，未配置則不發送）發送一封補貨提醒郵件；該告警只在「跌破」的那一次發送，補貨回到 50MB 以上後再次跌破才會重新告警。
Token 池為空或容量均已用盡時返回 50002，請先調用「導入 Token」接口補充。
本服務需項目簽名（app_id/timestamp/nonce/sign）；在線調試由服務端自動代簽。

GET /api/ImageHosting/picui/tokens 累計調用 3 次

查詢 Token 池

查看 Token 池整體容量與每個 Token 的已用 / 剩餘容量（Token 已脫敏）。

返回 data 頂層字段：
count：當前池內可用的 Token 數量
total_capacity_mb：全部 Token 的總容量合計（MB）
total_used_mb：全部 Token 的已用容量合計（MB）
total_remaining_mb：全部 Token 的剩餘容量合計（MB）—— 即系統當前還能上傳的總容量，看這個字段判斷是否要補貨
total_capacity_bytes / total_used_bytes / total_remaining_bytes：與上面三項一一對應的字節值，便於程序精確計算
items：池內每個 Token 的明細，字段如下：
items[].token：Token 脫敏值（保留首 6 位與末 4 位，如 657|uN****afdb）
items[].capacity_mb / items[].capacity_bytes：該 Token 的總容量
items[].used_mb / items[].used_bytes：該 Token 的已用容量
items[].remaining_mb / items[].remaining_bytes：該 Token 的剩餘容量（= 容量 − 已用，最小為 0）
items[].create_time：該 Token 的入庫時間
單位說明：容量同時提供 MB（保留 2 位小數，便於閱讀）與字節（便於計算）兩種單位。
容量用盡（已用 ≥ 容量）的 Token 會被自動刪除，因此 items 中出現的 Token 均可繼續使用；服務器只做容量記賬，不參與圖片存儲。

POST /api/ImageHosting/picui/tokens 累計調用 3 次

導入 Token

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

Token

選填：待新增的 Token，可多個（與 token_file 至少傳一項）

多值寫法：可重複傳參，或用逗號、換行分隔一次提交多個

Token 文件

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

單個容量(MB)

選填：每個 Token 的容量（MB），默認 50

Token 唯一：同一個 Token 只會入庫一條，重複導入不會重複寫入（庫中已存在、或同一批請求裡重複出現的，都計入 duplicated 跳過）。
tokens 支持重複字段、逗號或換行分隔，一次可提交多個 Token；Token 內不能含空格等空白字符（文件裡若帶注釋/多餘列會被拒絕，避免導入無效 Token）。
token_file 為按行存放 Token 的文本文件（一行一個），可與 tokens 同時使用。
返回 data 字段：submitted 本次提交的 Token 數（已按行/逗號拆分並去重）；created 實際新增數量；duplicated 因已存在而跳過的數量；duplicated_tokens 被跳過的 Token 脫敏列表；capacity_bytes / capacity_mb 每個新 Token 的容量。
單次最多導入 1000 個 Token；本服務需項目簽名（app_id/timestamp/nonce/sign）。