动漫截图搜索 API 文档

通过公开 API 将动漫截图搜索集成到你的应用中，用简单的 HTTP 请求即可程序化识别番剧、集数和场景时间戳。

免费额度

登录用户：当天可获得 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"}'