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