隨機圖片 API 與訪客圖庫
這兩個功能都在：
text
系統設定 -> 其他設定隨機圖片 API
隨機圖片 API 會從指定目錄中隨機取出一個檔案，適合做網站背景、頭像輪播或外部頁面的隨機圖片呼叫。
啟用後可以訪問：
text
https://你的網域/random隨機圖片 API 設定
| 選項 | 作用 |
|---|---|
| 啟用 | 開啟或關閉 /random，關閉時會拒絕訪問 |
| 目錄 | 限制隨機 API 可從哪些目錄取檔案 |
| 呼叫示範 | 產生可直接複製的隨機圖 API 連結 |
目錄可以選多個。例如只允許 /landscape/ 和 /portrait/，隨機 API 就只能從這兩個目錄或其子目錄取檔。
API 參數
| 參數 | 範例 | 作用 |
|---|---|---|
dir | /landscape/ | 指定隨機目錄 |
content | image | 指定媒體類型，可用 image、video、audio，也可逗號組合 |
orientation | auto | 圖片方向篩選，可用 portrait、landscape、auto |
type | url | 回傳格式。空白為跳轉，url 回傳純連結，json 回傳 JSON |
origin | 1 | 搭配 type=url 使用，回傳完整連結 |
age | all-ages,r12 | 年齡分級篩選 |
tag | wallpaper,sky | 只隨機包含這些標籤的檔案 |
ex | private | 排除包含這些標籤的檔案 |
回傳格式
不帶 type 時，會直接跳轉到隨機檔案位址。
type=url 回傳文字連結。
type=json 回傳檔案資訊，包含連結、檔案 ID、檔名、檔案類型、標籤、分級等。
存取限制
隨機圖片 API 會遵守後台公開訪問規則：
| 規則 | 效果 |
|---|---|
| 目錄限制 | 只能隨機允許目錄裡的檔案 |
| 黑名單 | 黑名單檔案不會進入候選池 |
| 白名單模式 | 開啟後只會回傳允許公開訪問的檔案 |
| 年齡分級 | 依目前存取模式過濾 R12、R16、R18 等內容 |
如果篩選後沒有可用檔案，會回傳沒有符合結果。
快取說明
隨機圖片 API 會快取目錄候選池，提高訪問速度。
檔案變更後，系統會更新目錄快取版本，後續請求會重新產生候選池。空目錄也會短時間快取，避免反覆查詢。
訪客圖庫
訪客圖庫提供只讀公開瀏覽頁，讓訪客查看你允許公開的目錄。
啟用後可以訪問：
text
https://你的網域/browse/目錄名訪客圖庫設定
| 選項 | 作用 |
|---|---|
| 啟用 | 開啟或關閉訪客圖庫 |
| 圖片載入模式 | 控制預覽使用原圖或縮圖 |
| 開放目錄 | 設定訪客可以訪問哪些目錄 |
開放目錄
例如填：
text
/1/,/2/,/landscape/,/portrait/訪客就可以訪問：
text
https://你的網域/browse/1
https://你的網域/browse/2
https://你的網域/browse/landscape
https://你的網域/browse/portrait也可以開放子目錄，例如 /2026/lucky/。訪客訪問未開放目錄會被拒絕。
訪客圖庫能做什麼
| 功能 | 說明 |
|---|---|
| 瀏覽目錄 | 查看開放目錄裡的檔案和子目錄 |
| 搜尋 | 依檔名、檔案 ID、標籤搜尋 |
| 類型篩選 | 篩選圖片、影片、音訊或其他檔案 |
| 標籤篩選 | 包含指定標籤或排除指定標籤 |
| 方向篩選 | 篩選橫圖或直圖 |
| 時間篩選 | 依上傳時間範圍篩選 |
| 副檔名篩選 | 依副檔名篩選 |
| 複製連結 | 複製檔案訪問連結 |
| 媒體預覽 | 圖片、影片、音訊可在訪客頁查看或播放 |
訪客圖庫訪問規則
| 規則 | 效果 |
|---|---|
| 開放目錄 | 只顯示允許開放的目錄 |
| 存取模式 | 依目前年齡分級存取模式過濾 |
| 白名單模式 | 開啟後只顯示允許公開訪問的檔案 |
| 黑名單 | 黑名單檔案不會顯示 |