1. 基本信息
| 接口地址 | https://v1.apizero.cn/api/hitokoto |
|---|
| 请求方法 | GET |
|---|
| 分类 | life |
|---|
| 提供方 | 极数本源 |
|---|
| 计费模式 | 免费试用 |
|---|
| 单次消耗 | 0 积分 |
|---|
| 起步价 | — |
|---|
| QPS 限制 | 20 req/s |
|---|
| 每日免费额度 | 500 次（已认证用户） |
|---|
| 匿名每日额度 | 200 次（无 API Key） |
|---|
| VIP 免费 | 否 |
|---|
| 调用次数 | |
|---|
3. 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|
c | string | 否 | 分类单字母 a-l（不传则全类别随机） | i |
min_length | number | 否 | 最小字符数 | — |
max_length | number | 否 | 最大字符数 | — |
5. 请求示例 (cURL)
curl "https://v1.apizero.cn/api/hitokoto?c=i&min_length=%3Cmin_length%3E&max_length=%3Cmax_length%3E&key=YOUR_API_KEY"
6. 响应字段
| 字段 | 类型 | 说明 | 示例 |
|---|
hitokoto | string | 语录原文 | — |
type | string | 分类字母 | — |
type_name | string | 分类中文名 | — |
from | string | 出处 | — |
from_who | string | 作者（可能为空） | — |
length | number | 字数 | — |
total_pool | number | 语录池总条数 | — |
7. 响应示例
{
"code": 0,
"msg": "成功",
"data": {
"id": 1234,
"hitokoto": "落霞与孤鹜齐飞，秋水共长天一色。",
"type": "i",
"type_name": "诗词",
"from": "滕王阁序",
"from_who": "王勃",
"length": 16,
"total_pool": 370
}
}
8. 错误码
| code | status | 说明 |
|---|
4000 | — | c 分类无效；min/max_length 越界或互斥 |
4000 | — | 当前过滤条件无可用语录 |