随机二次元图api

转载声明：本文改编自夜轻的《随机二次元图片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 的返回形式，便于在不同场景下快速接入。
文档同时补充了服务可用性监测、限流规则、浏览器缓存导致的重复图片问题、测试接口、投稿方式与更新日志，可作为接入说明和排障参考。

在线示例

自适应横图竖图可用性监测

自适应

接口地址

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

请求参数

请求示例

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

请求参数

请求示例

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。