EdgeOne Pages · 阿里云 ESA 多平台部署

一句话的力量
穿透你的心

高性能一言 API 服务,动漫、文学、诗词、影视等 12 大分类,近万条精选句子,边缘加速、全球低延迟、跨域友好。

正在加载...
8,985
精选句子
持续更新
12
句子分类
覆盖全场景
99.99%
服务可用性
边缘冗余
<50ms
边缘响应
全球加速

为性能而生

开箱即用的一言服务,覆盖从开发到生产的完整需求。

边缘加速

基于 EdgeOne 与阿里云 ESA 边缘节点,全球低延迟响应,自动就近接入。

🔄

多源镜像

多数据源自动切换,保障数据获取稳定性,即使单源故障也不影响服务。

📤

多种格式

支持 JSON、纯文本、JS 变量、JSONP 四种返回格式,适配各种接入场景。

🌐

全 CORS 支持

跨域友好,前端可直接调用,无需代理转发,简化接入流程。

🗂️

分类筛选

12 大分类自由组合,支持按句子长度过滤,精准获取所需内容。

💾

边缘缓存

智能边缘缓存 + 内存预加载,大幅降低回源压力,提升响应速度。

API 说明

动漫也好、小说也好、网络也好,不论在哪里,我们总会看到有那么一两个句子能穿透你的心。

请求地址

GEThttps://hitokoto.api.sylv.top/api
提示:本服务支持 EdgeOne Pages 和阿里云 ESA 多平台部署,数据来源于 hitokoto-osc/sentences-bundle

请求参数

参数可选说明
c见分类表句子类型
encodejson / text / js返回编码,默认 json
charsetutf-8字符集,默认 utf-8
callback如:moeJSONP 异步回调函数
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添加者用户标识
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 - 获取分类列表

12 大分类

可选择多个分类,例如 ?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 条

三步即可接入

无需复杂配置,几分钟即可在你的项目中集成一言服务。

01

调用接口

/api 发送 GET 请求,即可获取随机一言的 JSON 数据。

02

选择参数

按需添加分类、编码格式、长度过滤等参数,精准获取所需句子内容。

03

展示内容

在前端页面渲染返回的句子,支持纯文本、JSON、JS、JSONP 多种格式。

FAQ

关于一言 API 服务的常见问题解答。

数据来源于 hitokoto-osc/sentences-bundle 开源项目,通过 GitHub Actions 每天自动从远程源获取最新数据。
支持 EdgeOne Pages(腾讯云)和阿里云 ESA 两个平台部署。两个分支的 API 功能完全一致,仅部署平台和配置文件不同。
使用 ?c=分类码 参数指定分类,例如 ?c=a 获取动画类。支持多分类组合,如 ?c=a&c=c
完全支持。服务已开启全 CORS 支持,前端可直接调用,也支持 JSONP 回调方式跨域获取。
添加 ?encode=text 参数即可返回纯文本格式,此外还支持 json(默认)和 js 格式。