Anime API 项目

Anime API 是一个集合了不同类型免费动漫相关 API 的封装库。加入我们的 Discord 服务器。

为什么选择 anime-api（而不是其他）？

选择使用 anime-api 有以下几个原因：

• 直观：anime-api 设计直观。支持全面的自动补全。
• 完整：每个积极维护的 API 都没有遗漏任何功能。
• 简单：只需一行代码即可获取所有你想要的动漫信息。
• 合法：这本不需要说明，但所有 API 都是合法的。（没有免费的流媒体服务或其他）
• 积极维护：不时获得新版本（包含新的 API 封装）。

安装

使用 Poetry：

poetry add anime-api

使用 pip：

pip install anime-api

文档

完整文档可以在这里找到。

API

以下是当前支持和计划支持的 API：

名称	API 文档	是否可用
Anime Facts Rest API	文档	✅
Trace.moe	文档	✅
Animechan	文档	✅
Jikan (MyAnimeList)	文档	❌
Waifu Pics	文档	✅
Studio Ghibli API	文档	✅
Kitsu	文档	❌
AniList	文档	❌
AniDB	文档	❌
Kyoko	文档	✅
Animu	文档	✅
Anisearch	文档	❌
Anime News Network	文档	❌
Notify.moe (Anime Notifier)	文档	❌
Hmtai	文档	✅
Nekos.life	文档	✅
NekoBot	文档	✅
Neko-Love	文档	✅
Nekos.best	文档	✅
Nekos.moe	文档	✅
Shikimori	文档	❌
MangaDex	文档	❌
Danbooru	文档	❌
Yandere	文档	❌
Konachan	文档	❌
Waifu.im	文档	✅
Catboys	文档	✅
Anime Character Database	文档	❌
Nekos API	文档	✅

按功能分类的 API

你知道你想做什么，但不知道哪个 API 适合你？这个列表按功能对 API 进行排序。看看哪个最适合你！

图片

• Nekos API：
  • 数千张动漫图片
  • 大量图片元数据
  • 积极开发（频繁新功能、图片、类别等）
  • 100% 开源
  • v2.0.0 版本正在开发中
  • 官方 Python 封装（就是这个！）
  • 完全免费
• Animu：
  • 大量动漫 GIF 和图片
  • 从 60 多个不同类别获取反应 GIF
  • 完全免费
• Hmtai：
  • 大量动漫 GIF 和图片
  • SFW 和 NSFW 图片
  • 从 70 多个不同类别获取随机图片
  • 完全免费
• Nekos.life
  • 大量不同的猫娘图片
  • 从 20 多个不同类别获取随机猫娘图片
  • 完全免费
• Waifu.pics
  • 大量不同的老婆图片
  • 从 30 多个类别获取随机图片
  • SFW 和 NSFW 图片
  • 单次 API 调用获取 30 张不同图片
  • 每次获取不同图片
  • 完全免费
• NekoBot
  • 大量不同的猫娘图片
  • 图片生成（表情包、CP 等）
  • 从 30 个不同类别获取随机图片
  • SFW 和 NSFW 图片
  • 完全免费
• Nekos.moe
  • 大量不同的猫娘图片
  • 高级图片搜索
  • 上传图片
  • 点赞和收藏图片
  • SFW 和 NSFW 图片
  • 获取任意数量的随机图片
  • 完全免费
• Nekos.best
  • 大量不同的猫娘图片
  • 从 35 多个不同类别获取随机图片
  • 单次 API 调用获取多张随机图片
  • 按类别、格式等搜索图片
  • 完全 SFW
  • 99.9% 的正常运行时间
  • 快速响应
  • 获取所有图片的来源
  • 完全免费

小知识

• Anime Facts Rest API：
  • 大量不同的动漫小知识
  • 获取某个动漫的随机小知识
  • 保存小知识 ID 并稍后重新获取
  • 获取所有可用动漫列表
  • 完全免费
• Animu：
  • 大量动漫小知识
  • 获取随机动漫小知识
  • 完全免费
• Kyoko：
  • 大量不同的动漫小知识
• 从3个不同类别中获取随机反应gif
  • 完全免费
• Nekos.life
  • 大量不同的动漫事实
  • 获取随机动漫事实
  • 完全免费

名言

• Animechan:
  • 从大量角色和动漫列表中获取各种不同的名言
  • 获取随机动漫名言
  • 通过单次API调用获取10个随机动漫名言
  • 按角色名或动漫标题搜索名言
  • 获取所有可用动漫的列表
  • 完全免费
• Animu:
  • 大量不同的动漫名言，附带说话者和出处信息
  • 获取随机动漫名言
  • 完全免费
• Kyoko:
  • 大量不同的动漫名言
  • 获取随机名言，附带说话者和出处信息
  • 完全免费

老婆

• Animu:
  • 来自电子游戏、动漫、电影等的大量不同老婆
  • 获取随机老婆，包括她们的统计数据、来源、多张图片等
  • 完全免费

动漫

• 动漫事实REST API:
  • 获取大量蛇形命名的动漫标题列表，包括它们的图片和相关事实
  • 完全免费
• Animechan:
  • 获取大量动漫标题列表，附带随机名言
  • 完全免费
• 吉卜力工作室API
  • 获取吉卜力工作室动漫信息，如导演、制片人等
  • 支持动态加载
  • 获取非常具体的动漫细节，如交通工具、地点、人物和物种
  • 完全免费

娱乐

• Nekos.life
  • 从魔法8球获取答案，附带显示答案的8球图片
  • 获取随机"为什么？"问题
  • 完全免费

工具

• Trace.moe
  • 通过截图查找动漫，提供具体动漫、集数和截图时间的信息
  • 完全免费
• Nekos.life
  • 获取随机猫咪文本表情
  • 生成随机名字
  • 将文本转换为喵喵语（hello => hewwo）
  • 将文本标记为剧透（hello => ||hello||）（API端点当前有bug）
  • 完全免费
• Animu:
  • 生成安全密码
  • 完全免费

不会支持的API

• 非法动漫流媒体服务
• 非动漫相关的API
• 不是API的API（如网页爬虫）

贡献

在贡献之前请阅读以下内容：

添加API

如果你想添加API到列表中，请确保：

• API是免费使用的
• API与动漫相关（或漫画相关）
• 你遵循与其他API包装器相同的架构
• 为你编写的代码添加文档
• 在tests文件夹中添加所有必要的测试

修复API包装器

在修复API包装器之前，请确保：

• 该bug没有在其他PR中被修复
• 这确实是一个bug而不是功能（笑）
• 这不是API本身的bug
• 你已经创建了一个issue。如果你还没有创建issue，请在修复bug之前创建一个。

请求新的API

如果你想请求一个新的API，请确保：

• API是免费使用的
• API与动漫相关（或漫画相关）
• 它还不在列表中（无论是否可用）

一旦你检查完这些，请创建一个issue并包含以下信息：

• API的名称
• API文档链接
• API所有功能的列表

维护者

<table> <tr> <td style="align:center;"> <a href="https://github.com/Nekidev"> <img src="https://avatars.githubusercontent.com/u/84998222?s=256&v=4" height="100" width="100" alt="Nekidev头像" /> <br> <span>Nekidev</span> </a> </td> </tr> </table>