一言 API

随机返回一句动漫、文学、诗词、哲学等分类的句子

数据来源：Hitokoto 一言

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

随机一言，上游不可用时返回内置句子

GET /api/hitokoto

请求参数

  • type：分类，可多选（逗号分隔）：a=动画 b=漫画 c=游戏 d=文学 e=原创 f=来自网络 g=其他 h=影视 i=诗词 j=网易云 k=哲学 l=抖机灵，示例 a,d

返回字段

  • id（number|null）：一言句子 ID；返回内置兜底句子（fallback=true）时为 null
  • uuid（string|null）：一言句子 UUID；兜底句子时为 null
  • hitokoto（string）：句子正文
  • type（string）：分类代码：a=动画，b=漫画，c=游戏，d=文学，e=原创，f=来自网络，g=其他，h=影视，i=诗词，j=网易云，k=哲学，l=抖机灵
  • typeName（string）：type 对应的中文分类名（如 "动画"）；上游返回未知代码时为 "其他"
  • from（string|null）：出处（作品名、书名、诗词名等）；上游未提供时为 null
  • fromWho（string|null）：作者或说出这句话的角色；未知时为 null（上游句子和兜底句子都可能为 null）
  • creator（string|null）：在一言网站提交该句子的用户名；兜底句子时为 null
  • length（number）：句子长度（字符数，标点计入）；上游未提供时按 Unicode 字符数计算
  • url（string|null）：一言网站上该句子的页面（https://hitokoto.cn/?uuid={uuid}）；没有 uuid 时（含兜底句子）为 null
  • fallback（boolean）：是否为内置兜底句子。false：正常取自一言上游；true：上游请求失败、超时（5 秒）或返回格式无法识别，改为从内置句子库中按所选分类随机取一条，此时 id、uuid、creator、url 均为 null。所选分类在内置库中没有句子时（如 g=其他）从全部内置句子中取，type 可能与请求的分类不同