转载声明：本文改编自夜轻的《随机二次元图片API文档》。原文：https://blog.yeqing.net/acg-api/，开源项目：Yeqingky/acg-api。改编部分为自建 API 的接入地址与监控信息。本文采用 CC BY-NC-SA 4.0 许可协议。
前言
本文主要内容为随机二次元图片 API 的核心接口与调用方式，包括自适应入口 api.php、横图接口 pc.php、竖图接口 pe.php，以及 return=json 和 return=all 的返回形式，便于在不同场景下快速接入。
文档同时补充了服务可用性监测、限流规则、浏览器缓存导致的重复图片问题、测试接口、投稿方式与更新日志，可作为接入说明和排障参考。
在线示例
重要提醒
- 本服务为爱发电，不会接受任何形式的赞助或付费支持。
- 本服务不保证可用性（SLA），但会尽力做到高可用性。
- 速率限制：10 秒内超过 20 次请求将触发 30 秒的速率限制。
- 接口源站部署于阿里云轻量应用服务器；使用 EdgeOne 完成全球可用区分发，海外调用速度可能较慢或失败。
自适应
接口地址
https://acg.neko-arc.top/api.php
请求方法
GET
请求示例
302 重定向
请求 URL：
1
| https://acg.neko-arc.top/api.php
|
返回结果：302 重定向至 pc.php 或 pe.php
提示：api.php 不会处理 ?return= 参数，如需要请直接调用 pc.php 或 pe.php。
实现逻辑
判断 User-Agent 中是否存在移动端关键词，正则表达式如下：
1
| /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://acg.neko-arc.top/pc.php
请求方法
GET
请求参数
| 参数名 | 参数值 | 参数类型 | 参数描述 |
|---|
| return | 空 | 默认 | 302 重定向 |
| return | json | 可选 | 返回图片信息 |
| return | all | 可选 | 返回全部图片直链 |
请求示例
302 重定向
请求 URL：
1
| https://acg.neko-arc.top/pc.php
|
返回结果：302 重定向至图片 URL
JSON 格式返回
请求 URL：
1
| https://acg.neko-arc.top/pc.php?return=json
|
返回结果：
1
2
3
4
5
6
7
| {
"code": "200",
"acgurl": "图片URL",
"width": "图片宽度",
"height": "图片高度",
"size": "文件扩展名"
}
|
示例：
1
2
3
4
5
6
7
| {
"code": "200",
"acgurl": "https://acg.neko-arc.top/h/2acb9e178beb19adddd23e955d0a8af5.jpg",
"width": "1500",
"height": "1073",
"size": "jpg"
}
|
获取全部图片直链
请求 URL：
1
| https://acg.neko-arc.top/pc.php?return=all
|
返回结果：
1
2
3
4
| https://acg.neko-arc.top/h/0381c302baf7023a0a8097ce134e3663.jpg
https://acg.neko-arc.top/h/094727be0bbb380e7d79f94674817468.jpg
https://acg.neko-arc.top/h/0fccb30de2aa302da768f91c7929cffa.jpg
...
|
竖图
接口地址
https://acg.neko-arc.top/pe.php
请求方法
GET
请求参数
| 参数名 | 参数值 | 参数类型 | 参数描述 |
|---|
| return | 空 | 默认 | 302 重定向 |
| return | json | 可选 | 返回图片信息 |
| return | all | 可选 | 返回全部图片直链 |
请求示例
302 重定向
请求 URL：
1
| https://acg.neko-arc.top/pe.php
|
返回结果：302 重定向至图片 URL
JSON 格式返回
请求 URL：
1
| https://acg.neko-arc.top/pe.php?return=json
|
返回结果：
1
2
3
4
5
6
7
| {
"code": "200",
"acgurl": "图片URL",
"width": "图片宽度",
"height": "图片高度",
"size": "文件扩展名"
}
|
示例：
1
2
3
4
5
6
7
| {
"code": "200",
"acgurl": "https://acg.neko-arc.top/v/2026-07-060e1416ea0f395d.jpg",
"width": "1707",
"height": "2560",
"size": "jpg"
}
|
获取全部图片直链
请求 URL：
1
| https://acg.neko-arc.top/pe.php?return=all
|
返回结果：
1
2
3
4
| https://acg.neko-arc.top/v/04194946e7ee6eec7cd113942080f5ab.webp
https://acg.neko-arc.top/v/05951b8fa90644da08edf1bcbd0c1bbe.webp
https://acg.neko-arc.top/v/06b335c10810b49480150399b87fee6c.png
...
|
测试可用性
访问 https://acg.neko-arc.top/test.php 验证服务可用性：
1
2
3
| HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Hello World
|
常见问题
同一页面中多次调用 图片一样
在同一网页页面中，多次调用 https://acg.neko-arc.top/pe.php 图片一致。
问题原因
浏览器缓存导致的问题。因为引用的 URL 完全一致，浏览器会复用缓存。
解决办法
在 URL 中添加任意不同的查询参数，让浏览器不要复用缓存。
示例
问题示例： 同样的 URL，浏览器会直接复用缓存，多次调用图片一致。
1
2
| <img src="//acg.neko-arc.top/pc.php">
<img src="//acg.neko-arc.top/pc.php">
|
正确示例： 在 URL 后面添加任意不同的查询参数，让浏览器不要复用缓存。
1
2
| <img src="//acg.neko-arc.top/pc.php?1">
<img src="//acg.neko-arc.top/pc.php?2">
|
提交图片
如需投稿图片，可以去项目作者的QQ群提交，也可以提交给我。
版权声明
- 所有图片来源于互联网，包括但不限于
Telegram、QQ群、壁纸网站等。 - API 接口会收集 AIGC 图片。
- 本网站没有任何盈利行为，包括
赞助、打赏等。 - 不会收录有声明禁止转载的任何图片，但图片可能来源其他网站，且未声明禁止转载。
- 如有收录您的图片，可以联系站长删除。
- 本 API 仅提供随机返回图片 URL，任何网站/APP 等均可调用此 API。
更新日志
- 2026-08-24：自建部署完成。API 接入
acg.neko-arc.top:233，图床接入 acg.neko-arc.top:486，监控接入自建 Uptime。 - 2026-08-29：文档整理完成。
- 2026-08-29：CDN 分发完成。API 和图床均接入
acg.neko-arc.top。
]]>
