🖼️ 圖像 API beta

隨機高質量插畫，支援桌面 / 移動 / 貼紙，可按來源與大小篩選。

GET /image

總調用次數

今日調用

類別數

在線調試器

調整下方參數，即時預覽輸出並查看完整請求 URL 與 JSON Meta。

參數說明

查詢符	參數	描述
`category`	desktop	適合桌面端的圖像。
`category`	mobile	適合移動端的圖像。
`category`	sticker	貼紙 / 頭像。
`category`	auto	自動依 UA 判斷 desktop/mobile（或無參時亦自動）。
`source`	oneDrive, NekoData, NekoR2Data / all	依來源篩選；可用逗號分隔多來源，`all` 或空值=全來源隨機。
`minSize`	b / kb / mb / gb	限制最小檔案大小（未知大小也會通過）。
`maxSize` / size	b / kb / mb / gb	限制最大檔案大小；未找到符合時可能標記 noMatchWithinConstraints 並傳回 404。
`meta`	1 / 0	只回 JSON Meta（不跳轉、不輸出檔案）。
`proxy`	1 / 0	直接代理輸出（轉發遠端輸出）。
`redirect`	1 / 0	302 轉向；預設為 1（除非設 proxy）。

注意： category 可用半角逗號 , 組合（如 desktop,mobile）；source 同理，預設或 source=all 為使用全部來源；type 已棄用但仍兼容，請改用 category。

Meta

以 JSON 返回本次查詢的 Meta 資訊（不再重導向或直接輸出圖像）：

{
  "image": {
    "category": "desktop",
    "name": "93921212.jpg",
    "path": "https://data.oha.li/img/desktop/93921212.jpg",
    "size": 835217
  },
  "minSize": 102400,
  "limitSize": 2097152,
  "noMatchWithinConstraints": false
}

鍵	值	描述
image.category	desktop/mobile/sticker	本次選中的類別。
image.path	URL	實際文件地址（可遠端）。
image.name	String	文件名。
image.source	String	資料來源名稱（若設定來源時才會回傳）。
image.size	Int	文件大小（bytes），遠端可能為 0。
minSize	Int	最小限制（bytes），0 為無限制。
limitSize	Int	最大限制（bytes），0 為無限制。
noMatchWithinConstraints	Bool	若為 true 表示沒有找到符合 min/max 的檔案（將返回 404）。

使用範例

HTML 嵌入圖像：

<img src="/image?category=sticker&maxSize=1mb" alt="Sticker" />

CSS 背景圖像設定：

body {
  background-image: url('/image?category=desktop&maxSize=2mb');
  background-size: cover;
}

JavaScript 動態加載圖像：

fetch('/image?category=desktop&meta=1')
  .then(r => r.json())
  .then(d => { img.src = d.image.path; });

連通性測試

直接向各來源發送非代理的實際請求，以確認當前網路是否能連通到真正的檔案。

尚未測試