随机二次元图片API文档-晚染'blog

本文整理了随机二次元图片 API 的主要用法, 涵盖自适应入口 api.php, 横图接口 pc.php, 竖图接口 pe.php, 以及 return=json 和 return=all 等常见返回方式, 便于按需快速接入.
文档同时补充了服务可用性监测, 限流规则, 重复图片的缓存原因与处理方法, 以及测试接口和更新日志, 适合作为调用说明与排障参考.(AI摘要总结)

重要提示

本服务为爱发电,不会接受任何形式的赞助或付费支持.同时本服务也不保证可用性(SLA),但会尽力做到高可用性.
速率限制: 10秒内超过30次请求将触发30秒的速率限制.
本服务API接口源站部署在腾讯云广州；内容分发源站部署在腾讯云成都；使用 EdgeOne CDN 完成全球内容分发,海外调用速度较慢或可能调用失败.

提示!

新增?return=all参数可以直接获取全部图片直链不要再一直循环请求api了

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

自适应

接口地址

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

请求方法

GET

请求示例

302 重定向

请求 URL:

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

返回结果:
302 重定向至pc.php pe.php

提示!

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

实现逻辑

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

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

横图

接口地址

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

请求方法

GET

请求参数

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

请求实例

302 重定向

请求 URL:

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

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

JSON 格式返回

请求 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	可选	返回全部图片直链

请求实例

302 重定向

请求 URL:

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

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

JSON 格式返回

请求 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
…