EdgeOne Pages · 阿里云 ESA · 多源镜像
一句话，足以
穿透人心
为文字留白的极简 API。收录动漫、文学、诗词、影视等 12 类 8,985 条句子，边缘加速、全球低延迟、跨域友好。
正在加载…
8,985
精选句子
每日增补
12
句子分类
全场景覆盖
99.99%
服务可用
多源冗余
<50ms
边缘响应
全球加速
Features
克制，却完备
没有多余的修饰，只把必要的功能做得安静可靠。
边缘加速
基于 EdgeOne 与阿里云 ESA 边缘节点，就近接入，全球低延迟。
多源镜像
多数据源自动切换，单源故障不影响服务，稳定性优先。
多种格式
JSON / 纯文本 / JS 变量 / JSONP 四种返回，适配任意接入方式。
全 CORS 支持
开箱即跨域，前端直调无需代理，JSONP 亦可。
分类筛选
12 大类自由组合，支持按长度过滤，精准命中所需。
边缘缓存
智能边缘缓存 + 内存预加载，回源更少，响应更快。
API Reference
接口说明
“不论在哪里，总有那么一两个句子能穿透你的心。”
请求地址
GET https://hitokoto.api.sylv.top/api
支持 EdgeOne Pages 与阿里云 ESA 多平台部署。数据来自 hitokoto-osc/sentences-bundle。
请求参数
| 参数 | 取值 | 必填 | 说明 |
|---|---|---|---|
c | 见分类表 | 否 | 句子类型，可多选 ?c=a&c=c |
encode | json / text / js | 否 | 返回编码，默认 json |
charset | utf-8 | 否 | 字符集，默认 utf-8 |
callback | 如：moe | 否 | JSONP 回调函数 |
select | 默认 .hitokoto | 否 | 配合 encode=js 的选择器 |
min_length | 默认 0 | 否 | 最小长度（包含） |
max_length | 默认 30 | 否 | 最大长度（包含） |
示例请求
GET /api?c=f
GET /api?encode=text
GET /api?callback=myCallback
GET /api?min_length=10&max_length=50
返回值
| 字段 | 说明 |
|---|---|
id | 一言标识 |
uuid | 唯一标识 |
hitokoto | 正文 |
type | 类型代码 |
from | 出处 |
from_who | 作者 |
creator | 添加者 |
creator_uid | 添加者 ID |
length | 句子长度 |
响应示例
{
"id": 7338,
"uuid": "75a45fd4-4f2f-45eb-80cb-6f0a7bcdfaf2",
"hitokoto": "用代码表达言语的魅力，用代码书写山河的壮丽。",
"type": "f",
"from": "一言开发者中心",
"from_who": "一言",
"creator": "DreamOne",
"creator_uid": 9209,
"length": 22
}
其他接口
GET /api/categories — 获取分类列表
Categories
十二种心境
多选以 ?c=a&c=c 组合，未知参数将视作动画类型。
a
动画
Anime
1,447
b
漫画
Comic
109
c
游戏
Game
1,004
d
文学
Literature
1,866
e
原创
Original
1,422
f
网络
Internet
960
g
其他
Other
748
h
影视
Movie
190
i
诗词
Poetry
737
j
网易云
Netease
124
k
哲学
Philosophy
302
l
抖机灵
Wit
76
How it works
三步，接入
无需配置，几分钟即可让你的页面拥有“今日一言”。
01
调用接口
向 /api 发起 GET 请求，立即获得随机句子的 JSON。
02
选择参数
按需附加分类、编码、长度等参数，精确筛选所需心境。
03
展示内容
渲染返回字段，支持 JSON / Text / JS / JSONP，多端一致。
FAQ
常见问题
关于服务的细枝末节，集中作答。
数据来自 hitokoto-osc/sentences-bundle 开源项目，通过 GitHub Actions 每日自动同步最新句子。
支持 EdgeOne Pages（腾讯云）与阿里云 ESA。二者 API 完全一致，仅部署配置与构建产物不同。
使用
?c=分类码，如 ?c=a 获取动画类；多分类可组合 ?c=a&c=c。完全支持。已开启全量 CORS，浏览器可直调；亦提供 JSONP 回调方式。
附加
?encode=text 即返回纯文本；默认 json，另支持 js。