API 文件

透過我們的公開 API，將動漫截圖搜尋整合到你的應用程式。

免費額度

登录用户：当天可获得 10 点免费额度（午夜失效），之后每次搜索 1 点额度。升级获取更多。

認證注意事項

基於 Session 的端點需要有效的 better-auth session cookie。從伺服器端或非瀏覽器客戶端呼叫時，請帶上 Origin header（例如 Origin: https://your-domain.com），並保存 /api/auth/sign-in/email 返回的 cookie。

POST/api/anime/search

透過上傳圖片檔案或提供圖片 URL，搜尋動漫場景。回傳最多 5 個含時間戳與相似度分數的候選結果。

驗證: Session 或 API key

參數

名稱	類型	必填	說明
image	File	否	圖片檔案 (JPEG/PNG)
url	string	否	公開圖片 URL

访客：每个 IP 每天 5 次。登录用户：每日 10 点免费额度，之后每次搜索 1 点，每小时 100 次。

示例

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -F "url=https://example.com/screenshot.png"

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "url=https://example.com/screenshot.png"

GET/api/anime/rankings

依期間取得最熱門動漫排行。

驗證: 無

參數

名稱	類型	必填	說明
period	string	否	daily \| weekly \| monthly \| yearly \| all（預設：all）
limit	number	否	最大結果數（預設：50）
includeAdult	boolean	否	包含 NSFW 項目（預設：false）

無需認證。

示例

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"

GET/api/anime/recent-searches

取得最近確認的公開搜尋。

驗證: 無

參數

名稱	類型	必填	說明
limit	number	否	最大結果數
offset	number	否	分頁偏移量

公開端點。

示例

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"

GET/api/user/anime-credits

取得目前登入用戶剩餘的動漫搜尋額度。

驗證: Session

僅限登入用戶。

示例

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"

GET/api/apikeys

列出你的 API key。

驗證: Session

參數

名稱	類型	必填	說明
page	number	否	頁碼
pageSize	number	否	每頁項目數

僅限登入用戶。

示例

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"

POST/api/apikeys

建立新的 API key。明文 key 只會回傳一次。

驗證: Session

參數

名稱	類型	必填	說明
title	string	是	key 的說明名稱

僅限登入用戶。

示例

curl -X POST https://whatanimeisthis.com/api/apikeys \
  -H "Content-Type: application/json" \
  -H "Cookie: <SESSION_COOKIE>" \
  -d '{"title":"my-key"}'