随机一言
正常
NEW
随机一言语句库，覆盖动画、漫画、游戏、文学、哲学、影视、诗词等多分类语句，支持分类筛选与批量返回。
协议：HTTP
格式：JSON
版本：v1.0.0日调用量：1268次
购买次数包更优惠，低至 0.0009 元/次
标准次数包
100,000 次调用
¥0.0009 /次
省 10%
接口说明
随机返回一句话，支持分类与数量控制
随机返回一言语句，支持 8 个分类（动画/漫画/游戏/文学/哲学/影视/诗词/其他）筛选与 1~10 条批量返回，可选 JSON 或纯文本输出。
调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。
GET
http://www.shujuyu.cn/v1/api/tool-hitokoto/hitokoto
JSON
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| key |
string |
是 |
您的API密钥，可在个人中心获取 |
| category |
string |
否 |
语录分类：a 动画 / b 漫画 / c 游戏 / d 文学 / e 哲学 / f 影视 / g 诗词 / h 其他，不传则全部分类随机 |
| limit |
integer |
否 |
返回条数，范围 1~10，不传默认 1 条；超出范围按边界值处理 |
| encoding |
string |
否 |
输出格式：json 结构化数据 / text 纯文本，不传默认 json |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|
| code |
integer |
状态码，200 表示成功 |
| msg |
string |
提示信息 |
| data.total |
integer |
当前筛选条件下可抽取的语录总数 |
| data.limit |
integer |
实际返回的条数 |
| data.list |
array |
一言列表 |
| data.list[].id |
integer |
语录ID（由内容哈希生成） |
| data.list[].category |
string |
语录分类（a~h） |
| data.list[].text |
string |
语录内容 |
| data.list[].from |
string |
语录出处/来源标签 |
请求示例
返回示例
{"msg":"success","code":200,"data":{"list":[{"id":28751099,"from":"文学","text":"愿你走出半生，归来仍是少年。","category":"d"},{"id":74594616,"from":"文学","text":"读书破万卷，下笔如有神。","category":"d"}],"limit":2,"total":10}}
产品说明
产品概述
随机一言语句库，覆盖动画、漫画、游戏、文学、哲学、影视、诗词等多分类语句，支持分类筛选与批量返回。
使用场景
数据查询：快速集成 随机一言 到您的应用中
业务系统：将 随机一言 数据嵌入业务流程
开发工具：通过 API 接口获取 生活服务 数据
数据分析：基于 随机一言 数据进行分析和决策
费用计算
按次计费单价
¥0.001
/ 次
每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣
扣费优先级
计费方式详解
· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次 的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。
预付费购买固定调用次数，最高可省 10%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。
按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：
个人版9折
专业版8折
企业版7折
量折扣：
月付费调用 ≥1000 次享 2%、
月付费调用 ≥10000 次享 5%、
月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。
次数包方案
| 方案名称 | 调用次数 | 价格 | 折算单价 | 比按次付费节省 | 有效期 |
| 标准次数包 |
100000 次 |
¥90 |
¥0.0009/次 |
省10% |
365 天 |
VIP 权益对比
| 等级 | 每月免费次数 | 本接口月免费上限 | 折扣 | VIP 折后单价 |
| 免费版 |
按接口配置 |
— |
- |
¥0.001/次 |
| 个人版 |
5000 次 |
5000 次 |
10% |
¥0.0009/次 |
| 专业版 |
30000 次 |
30000 次 |
20% |
¥0.0008/次 |
| 企业版推荐 |
200000 次 |
200000 次 |
30% |
¥0.0007/次 |
* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。
本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。
费用计算示例
* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。
示例1：普通用户按次付费
调用 1000 次，费用 = 0.001 × 1000 = ¥1.00
示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）
调用 1000 次，折扣约 10%，费用 = 0.001 × (1 - 10%) × 1000 ≈ ¥0.90
示例3：购买「标准次数包」次数包
支付 ¥90.00，获得 100000 次调用，折算单价 ¥0.0009/次
同等次数按次付费需 ¥100.00，次数包可节省 ¥10.00
错误码说明
| 错误码 | 说明 | 解决方案 |
|---|
| 200 |
请求成功 |
- |
| 400000 |
请求参数错误 |
检查参数名、格式与取值；具体原因见响应 msg |
| 401000 |
认证失败 |
检查 Authorization: Bearer 密钥是否正确、是否过期 |
| 402000 |
账户余额不足 |
充值后重试 |
| 403000 |
无访问权限 |
确认密钥权限、接口范围与 IP 白名单是否满足要求 |
| 404001 |
接口或端点不存在 |
检查 API 与端点的请求路径 |
| 409000 |
请求冲突 |
请稍后重试 |
| 422000 |
参数校验失败 |
检查参数格式与取值 |
| 429000 |
请求频率或额度超限 |
降低调用频率，或升级套餐提升额度 |
| 500000 |
服务器内部错误 |
携带响应中的 request_id 联系技术支持 |
| 502000 |
服务暂时不可用 |
稍后重试 |
| 503000 |
服务暂时不可用 |
稍后重试 |
| 504000 |
请求超时 |
稍后重试 |