API 文档
5 分钟上手:注册拿 Key → 复制地址 → 直接用
三步用上随机图片 API
1
注册登录,拿到你的 API Key
点击本站右上角登录 → 进入「个人中心」→ 复制你的专属 API Key(ak_ 开头的一串字符)。它是你的调用凭证,所有接口都要带上它。
2
选一种用法(见下方对比)
不想写代码 → 用直链模式,把接口地址直接当图片链接;要写程序 → 用 JSON 模式,从返回数据里取图片地址。两种用法见下面的详细说明。
3
复制地址就能用了
到「接口列表」标签页,每个接口都配了一键复制按钮。想换分类,把地址里的分类名换掉即可;想先看效果,去网站顶部「体验」页面在线试。
两种用法,看你的场景选
同一个接口,加不加 type 参数决定输出内容
推荐
直链模式(不写代码)
地址末尾加 &type=img,接口地址直接就是一张图
https://api.zxiaolin.com/api/v1/random/anime?key=你的Key&type=img- • 浏览器打开直接显示图片,刷新换一张
- • 挂网页:放进 <img src="这里">
- • 发帖子:Markdown 里当图片链接贴
- • 视频同理:加
&type=video
默认
JSON 模式(写程序)
什么参数都不加,返回一段 JSON 数据
{
"url": "https://...图片地址",
"id": 15,
"category": "anime",
"category_name": "二次元"
}- • 程序里 fetch / requests 调用
- • 从
url字段拿图片地址 - • 可拿到编号、分类等信息做业务逻辑
- • 适合下载、批量处理、二次开发
接口地址是怎么构成的?
看懂这一段,所有接口你都会拼了
https://api.zxiaolin.com站点地址(固定不变)/api/v1/random/图片接口路径anime分类 slug(换成别的分类名)?key=ak_xxx你的 API Key(必填)&type=img输出为图片直链(可选)换分类:把 anime 换成其他分类的 slug(见下方分类列表),比如 landscape、food。
用视频接口:把路径里的 /api/v1/random/ 换成 /api/v1/video/,type 参数换成 video。
Key 的两种带法(等效):网址参数 ?key=ak_xxx 或请求头 X-API-Key: ak_xxx。网页里用前者,程序里推荐后者。
可用分类
🖼️ 动漫图片
动漫二次元图片
/api/v1/random/anime🖼️ 小姐姐图片
精美小姐姐图片
/api/v1/random/girl🖼️ 风景图片
自然风景图片
/api/v1/random/scenery🖼️ 动物图片
可爱动物图片
/api/v1/random/animal🖼️ 美食图片
美食图片
/api/v1/random/food🖼️ 随机图片
随机图片
/api/v1/random/random