随机二次元图片API文档

本文汇总了随机二次元图片 API 的核心接口与调用方式, 包括自适应入口 api.php, 横图接口 pc.php, 竖图接口 pe.php, 以及 return=json 和 return=all 的返回形式, 便于在不同场景下快速接入.
文档同时补充了服务可用性监测, 限流规则, 浏览器缓存导致的重复图片问题, 测试接口, 投稿方式与更新日志, 可作为接入说明和排障参考. (AI摘要总结)

https://uptime.yppp.net/status/status

重要提示

此服务不保证可用性(SLA), 但会尽力做到高可用性.
速率限制: 10 秒内超过 20 次请求将触发 30 秒的速率限制.
API 接口部署在腾讯云广州; 内容分发部署在腾讯云成都; 使用 EdgeOne CDN 完成全球内容分发, 海外调用速度较慢或可能调用失败.

开源地址: https://github.com/Yeqingky/acg-api . 求 Star !!!

自适应接口#

提示!

api.php不会处理?return=参数如需要请直接调用pc.php或pe.php

接口地址: https://api.yppp.net/api.php
请求方式: GET
返回结果: 302 重定向至pc.php pe.php

判断逻辑: 判断 User-Agent 中是否存在关键词正则表达式如下

/Android|iP(hone|od)|Windows ?CE|Symbian|Mobile|Opera Mobi|BlackBerry|Palm(OS)?|PocketPC|SonyEricsson|Nokia|Vodafone|HTC_|SAMSUNG-SGH|armv[56]l|Go\.Web|J2ME\/MIDP/i

命中后将重定向至 pe.php ; 如未命中则重定向至 pc.php . 推荐您直接调用 pe.php pc.php , 此方式判断可能存在误差.

横图接口#

接口地址: https://api.yppp.net/pc.php
请求方法: GET

请求示例#

参数名	参数值	参数类型	参数描述
return	空	默认	302 重定向
return	json	可选	返回图片信息
return	all	可选	返回全部图片直链

请求 URL:

https://api.yppp.net/pc.php

返回结果: 302 重定向至图片 URL

请求 URL:

https://api.yppp.net/pc.php?return=json

返回结果:

{
  "code": "200",
  "acgurl": "图片URL",
  "width": "图片宽度",
  "height": "图片高度",
  "size": "文件扩展名"
}

示例:

{
  "code": "200",
  "acgurl": "https://list.yppp.net/d/image/2025-10-4fa10e18f4b501b44ac16a481591009c.png",
  "width": "2290",
  "height": "1200",
  "size": "png"
}

ps: 懒得做去重所以可能有重复的图片

请求 URL:

https://api.yppp.net/pe.php?return=all

返回结果:

https://list.yppp.net/d/image/2025-12-ea81eb4869f8e06dd453397dfa1bcb91.jpg
https://list.yppp.net/d/image/2025-12-b761eb23b6b5e294b0d023fe7f0e3cd9.jpg
https://list.yppp.net/d/image/2025-12-28f962e630843b647291559e9175ad32.jpg
...

竖图接口#

接口地址: https://api.yppp.net/pe.php
请求方法: GET

请求示例#

参数名	参数值	参数类型	参数描述
return	空	默认	302 重定向
return	json	可选	返回图片信息
return	all	可选	返回全部图片直链

请求 URL:

https://api.yppp.net/pe.php

返回结果: 302 重定向至图片 URL

请求 URL:

https://api.yppp.net/pe.php?return=json

返回结果:

{
  "code": "200",
  "acgurl": "图片URL",
  "width": "图片宽度",
  "height": "图片高度",
  "size": "文件扩展名"
}

示例:

{
  "code": "200",
  "acgurl": "https://list.yppp.net/d/image/2025-11-70d2a532693486587cb485c603f6733c.png",
  "width": "1505",
  "height": "2048",
  "size": "png"
}

ps: 懒得做去重所以可能有重复的图片

请求 URL:

https://api.yppp.net/pe.php?return=all

返回结果:

https://list.yppp.net/d/image/2025-12-7f00fcf2cdb0a69fb89b5095c58a83f9.png
https://list.yppp.net/d/image/2025-12-84f0ec926d49de50487ac4cfe7bd95d0.jpeg
https://list.yppp.net/d/image/2025-12-b4834669347c99fa4210875e217fa640.jpeg
...

测试可用性#

可以通过请求/test.php 来用于验证可用性.

https://api.yppp.net/test.php

返回内容如下:

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Hello World

常见问题#

同一页面中多次调用返回图片一样#

比如在同一网页页面中, 多次调用 https://api.yppp.net/pe.php 返回的图片一样.

问题原因是: 这是浏览器缓存导致的问题因为引用的URL完全一致浏览器会复用缓存

解决办法: 在URL后面添加任意查询参数让浏览器不要复用缓存

示例#

{% image //api.yppp.net/pc.php %}
{% image //api.yppp.net/pc.php %}

调用

图片1

图片2

{% image //api.yppp.net/pc.php?1 %}
{% image //api.yppp.net/pc.php?2 %}

提交图片#

您可以进群 959731247 分享您的图片.

本站对图片质量要求较高并非所有二次元图片都会收录

版权声明#

所有图片来源于互联网包括但不限于 QQ群 壁纸网站 等.
可能会收集 AIGC 图片.
不会收录有声明禁止转载的任何图片,但图片可能来源其他网站,且未声明禁止转载.
如有收录您的图片,您可以发送邮件至(me@yeqing.im).

更新日志#

新增 4 张横图 40 张竖图. GitHub Commit

新增 19 张横图 39 张竖图. GitHub Commit

新增 8 张横图 51 张竖图. GitHub Commit

新增 7 张横图 61 张竖图. GitHub Commit

新增 24 张横图 29 张竖图. GitHub Commit

新增 10 张横图 49 张竖图. GitHub Commit

更新文档添加可用性监测徽章.

新增 15 张横图 66 张竖图. GitHub Commit

移除了一些轻NSFW图.

新增 8 张横图 43 张竖图.

新增 8 张横图 24 张竖图.

新增 20 张竖图.

~~添加更新日志~~

自适应接口#

横图接口#

请求示例#

竖图接口#

请求示例#

测试可用性#

常见问题#

同一页面中多次调用 返回图片一样#

示例#

提交图片#

版权声明#

更新日志#

同一页面中多次调用返回图片一样#