Demo

demo.ani.api.kihh.xyz

请求方式

GET https://ani.api.kihh.xyz/?q={关键词}[&direct]

参数说明

参数 必填 说明
q 是 搜索关键词，支持 URL 编码的中文/英文
direct 否 直接跳转到第一个结果的封面图片，忽略其他结果（适用于快速获取首张封面）

响应规则

根据匹配结果数量和参数组合，返回以下三种响应形式：

  1. 多结果默认响应
    当搜索匹配多个条目且未添加 &direct 参数时，返回 JSON 数组，包含所有匹配结果。
  2. 强制直接重定向
    当添加 &direct 参数时，无论匹配数量，均重定向到​​第一个结果​​的封面图片 URL（HTTP 302）。

示例请求与响应

示例 1：多结果默认响应

请求：

GET https://ani.api.kihh.xyz/?q=埃罗芒阿老师

响应（JSON 数组）：

[
  {
    "title": "Eromanga-sensei",
    "id": "11981",
    "cover": "https://ani.api.kihh.xyz/id/11981"
  },
  {
    "title": "Eromanga-sensei OVA",
    "id": "13580",
    "cover": "https://ani.api.kihh.xyz/id/13580"
  }
]

示例 2：强制直接重定向

请求：

GET https://ani.api.kihh.xyz/?q=埃罗芒阿老师&direct

响应行为：
HTTP 302 跳转到第一个封面 URL

Location: https://ani.api.kihh.xyz/id/11981

注意事项

  1. 封面 URL 结构
    封面地址格式为 https://ani.api.kihh.xyz/id/{id}，支持通过 ID 直接访问图片资源。
  2. 错误处理
    无匹配结果或无效 ID 访问封面返回 404 错误。