一言（简版）
yiyanGETGET
https://v1.apizero.cn/api/yiyan概述
hitokoto 的精简版：纯文本随机一句，不带分类/出处。同时支持 format=text 直接返回纯文本（适合站点页脚、小程序欢迎语等装饰场景）。
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/yiyan/raw.md鉴权
匿名免登录可调每日 200 次；登录用户每日 500 次。
获取 API Key：获取 API Key/account/keys
请求头
Authorizationstring选填
推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 否 | 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
请求参数
GET · QUERY STRING · https://v1.apizero.cn/api/yiyan?format=json
formatstring选填
json（默认）/ text
例json
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| format | string | 否 | json（默认）/ text | json |
返回结果
顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id
contentstring
随机句子（仅 format=json 时）
lengthnumber
字数
total_poolnumber
语录池总条数
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 |
|---|---|---|
| content | string | 随机句子（仅 format=json 时） |
| length | number | 字数 |
| total_pool | number | 语录池总条数 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"content": "落霞与孤鹜齐飞，秋水共长天一色。",
"length": 16,
"total_pool": 370
},
"tips": "极数本源 · https://apizero.cn"
}请求示例
示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。
curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/yiyan?format=json"错误码
先看业务 code。HTTP 也可能不是 200。
0200
成功
4000400
参数错误
4011401
API Key 无效
4013403
API Key 已暂停
4014403
当前 IP 不在 Key 白名单
4015401
此接口需要 API Key
4022402
余额不足
4029429
调用过快（QPS）
4030429
今日免费额度已用完
4040503
接口已下线
4041404
接口不存在
5000500
服务器内部错误
5020502
上游暂时不可用
5021502
上游返回格式异常
5030502
暂无可用节点
| 业务码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 4000 | 400 | 参数错误 |
| 4011 | 401 | API Key 无效 |
| 4013 | 403 | API Key 已暂停 |
| 4014 | 403 | 当前 IP 不在 Key 白名单 |
| 4015 | 401 | 此接口需要 API Key |
| 4022 | 402 | 余额不足 |
| 4029 | 429 | 调用过快（QPS） |
| 4030 | 429 | 今日免费额度已用完 |
| 4040 | 503 | 接口已下线 |
| 4041 | 404 | 接口不存在 |
| 5000 | 500 | 服务器内部错误 |
| 5020 | 502 | 上游暂时不可用 |
| 5021 | 502 | 上游返回格式异常 |
| 5030 | 502 | 暂无可用节点 |
调用限制
- 计费模式
- 完全免费
- QPS 限制
- QPS 3
- 登录免费额度
- 500000 次（已认证）
- 匿名每日额度
- 200000 次（无 API Key）
- 黄金会员
- 每天 50,000 次 · QPS 10
- 钻石会员
- 每天 100,000 次 · QPS 30
- 企业会员
- 每天 1,000,000 次 · QPS 120
| 计费模式 | 完全免费 |
|---|---|
| QPS 限制 | QPS 3 |
| 登录免费额度 | 500000 次（已认证） |
| 匿名每日额度 | 200000 次（无 API Key） |
| 黄金会员 | 每天 50,000 次 · QPS 10 |
| 钻石会员 | 每天 100,000 次 · QPS 30 |
| 企业会员 | 每天 1,000,000 次 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.0.02026-05-07
首次上线 · 支持 text 纯文本输出