WAIT — What Anime Is This

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

参数

名称类型必填说明
imageFile否图片文件 (JPEG/PNG)
urlstring否公开图片 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
按期间获取最热门动漫排行。
认证: 无

参数

名称类型必填说明
periodstring否daily | weekly | monthly | yearly | all（默认：all）
limitnumber否最大结果数（默认：50）
includeAdultboolean否包含 NSFW 项目（默认：false）

无需认证。

示例

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
获取最近确认的公开搜索。
认证: 无

参数

名称类型必填说明
limitnumber否最大结果数
offsetnumber否分页偏移量

公开端点。

示例

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

参数

名称类型必填说明
pagenumber否页码
pageSizenumber否每页项目数

仅限登录用户。

示例

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
创建新的 API key。明文 key 只会返回一次。
认证: Session

参数

名称类型必填说明
titlestring是key 的说明名称

仅限登录用户。

示例

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