一言
用代码表达言语的魅力，用代码书写山河的壮丽。
文档地址
https://developer.hitokoto.cn/sentence
|
请求地址
| 地址 |
协议 |
方法 |
QPS 限制 |
线路 |
v1.hitokoto.cn |
HTTPS |
Any |
2 |
全球 |
international.v1.hitokoto.cn |
HTTPS |
Any |
20(含缓存*) |
海外 |
请求参数
| 参数 |
值 |
可选 |
说明 |
| c |
见后表 |
是 |
句子类型 |
| encode |
见后表 |
是 |
返回编码 |
| charset |
见后表 |
是 |
字符集 |
| callback |
如：moe |
是 |
调用的异步函数 |
| select |
默认：.hitokoto |
是 |
选择器。配合 encode=js 使用 |
| min_length |
默认：0 |
是 |
返回句子的最小长度（包含） |
| max_length |
默认：30 |
是 |
返回句子的最大长度（包含） |
句子类型（参数）
| 参数 |
说明 |
| a |
动画 |
| b |
漫画 |
| c |
游戏 |
| d |
文学 |
| e |
原创 |
| f |
来自网络 |
| g |
其他 |
| h |
影视 |
| i |
诗词 |
| j |
网易云 |
| k |
哲学 |
| l |
抖机灵 |
| 其他 |
作为 动画 类型处理 |
可选择多个分类，例如： ?c=a&c=c
返回编码（参数）
| 参数 |
说明 |
| text |
返回纯洁文本 |
| json |
返回格式化后的 JSON 文本 |
| js |
返回指定选择器的同步调用函数。默认选择器为：.hitokoto |
| 其他 |
返回格式化后的 JSON 文本 |
字符集（参数）
| 参数 |
说明 |
| utf-8 |
返回 utf-8 编码的内容 |
| gbk |
返回 gbk 编码的内容。不支持与异步函数同用 |
| 其他 |
返回 utf-8 编码的内容 |
壁纸接口
支持输出必应壁纸与360壁纸，其中必应壁纸为当天壁纸而360则随机输出一张，具体参数及调用如下。
必应壁纸
如果你要在PC端调用，图片分辨率为 1920x1080，可使用如下接口
https://www.yumus.cn/api/?target=img&brand=bing&ua=pc
|
如果你需要调用分辨率为 3840x2160 的 4K 高清图片，可使用如下接口
https://www.yumus.cn/api/?target=img&brand=bing&ua=uhd
|
如果你要在手机端调用，图片分辨率为 1080x1920，可使用如下接口
https://www.yumus.cn/api/?target=img&brand=bing&ua=m
|
其中，参数 ua 用于指定PC还是移动端调用，若不填或填写错误，默认输出分辨率为1920x1080的图片。
360壁纸
360壁纸共支持15个类别的图片调用，无论哪个分类都是随机输出指定分类下的一张图片，分类参数与分类名对应关系如下表。
| 分类名 |
参数值 |
图片数量 |
| 4k专区 |
0 |
3558 |
| 美女模特 |
1 |
7401 |
| 爱情美图 |
2 |
4620 |
| 风景大片 |
3 |
10000 |
| 小清新 |
4 |
10000 |
| 动漫卡通 |
5 |
10000 |
| 明星风尚 |
6 |
10000 |
| 萌宠动物 |
7 |
9156 |
| 游戏壁纸 |
8 |
10000 |
| 汽车天下 |
9 |
10000 |
| 炫酷时尚 |
10 |
10000 |
| 影视剧照 |
11 |
9264 |
| 军事天地 |
12 |
2091 |
| 游戏壁纸 |
13 |
4903 |
| 文字控 |
14 |
1075 |
调用接口，其中参数 type 为分类参数，不填写分类参数或参数错误，统一随机输出一张4k专区图片。
https://www.yumus.cn/api/?target=img&brand=360&type=0
|
接口只支持直接输出图片链接，不支持 json 类型数据，且服务器仅对中国大陆网络访问良好，虽做了海外解析（走 Cloudflare 回退源）但港澳台及海外能不能良好调用依旧要看命。
