Hitokoto API 调用文档

本 API 用于获取各种类型的句子数据,通过传入不同参数,可控制返回结果。以下是各参数的详细说明:

基本 URL

调用地址示例:
https://api.sb6.me/hitokoto/api

请求参数

参数 描述 示例
c 句子类型。有效值及其对应类型:
  • a - 动画
  • b - 漫画
  • c - 游戏
  • d - 文学
  • e - 原创
  • f - 来自网络
  • g - 其他
  • h - 影视
  • i - 诗词
  • j - 网易云
  • k - 哲学
  • l - 抖机灵
如果未指定,获取全部数据
c=a
type 返回格式类型:
  • all:返回所有符合过滤条件的记录(JSON 数组);
  • json:返回随机一条完整的 JSON 对象;
  • 其它或未指定:返回随机一条一言(纯文本)。
type=json
max_length 过滤条件:仅返回 length 字段值小于等于该值的句子。 max_length=50
min_length 过滤条件:仅返回 length 字段值大于等于该值的句子。 min_length=10

调用示例

获取动画类句子的示例:

https://api.sb6.me/hitokoto/api?c=a

获取长度介于 10 和 50 之间(包括10和50),并以 JSON 格式返回随机一条记录的示例:

https://api.sb6.me/hitokoto/api?min_length=10&max_length=50&type=json

获取全部符合条件的句子(从所有类型中合并)示例:

https://api.sb6.me/hitokoto/api?type=all&min_length=10&max_length=50

数据来源

本API数据来源于hitokoto句子包

https://cdn.jsdelivr.net/gh/hitokoto-osc/sentences-bundle@1.0.425/

句子包版本:@1.0.425