Edge Random Image Service
随机图片，边缘分发
基于边缘计算的高性能图片 API 服务，为 Web 应用提供低延迟、高质量的随机图片分发能力。
374
PC 图池 · 张
694
移动图池 · 张
WebP
图片格式
v3.0
API 版本
为速度而生
构建世界级产品所需的一切能力，协同工作，无缝衔接。
边缘计算
基于边缘函数，全球节点就近响应，零延迟缓存，运行时无额外请求。
设备适配
自动检测客户端设备类型，智能返回 PC 端或移动端适配图片。
WebP 优化
采用现代 WebP 格式，体积更小、质量更高，兼顾性能与体验。
随机分发
从图片池随机选择，支持单张或批量获取，JSON、重定向、文本多种返回。
多平台部署
同时支持腾讯云 EdgeOne Pages 和阿里云 ESA，灵活选择部署平台。
零配置使用
直接访问 /api 或 /image 即可获取图片，无需复杂参数配置。
在线体验
点击按钮获取一张随机图片，感受边缘加速。
三步开始使用
几分钟即可完成接入，无需复杂配置。
壹
调用接口
访问 /api 或 /image 端点，系统自动检测设备类型。
贰
边缘响应
就近边缘节点处理请求，随机选择图片并返回。
叁
集成使用
在 HTML、CSS 或应用中直接引用返回的图片 URL。
图库
浏览所有可用图片资源，支持 PC 端与移动端切换。
加载中…
设备：PC 端
1 / 1
API 文档
完整的接口使用指南与参考，快速集成随机图片服务。
GET
/api
获取随机图片，支持多种返回格式
请求参数
count
integer
可选
返回图片数量，范围 1–50。
默认值：1
type
string
可选
设备类型，决定返回图片的适配方向。
可选值：pc（横屏）、pe（竖屏）｜默认：自动检测
format
string
可选
图片格式。
可选值：webp｜默认：webp
return
string
可选
返回类型。
可选值：redirect、json、text｜默认：json
响应示例
{
"success": true,
"count": 2,
"type": "pc",
"format": "webp",
"images": [
{
"url": "https://example.com/converted/pc/webp/xxx.webp",
"format": "webp",
"type": "pc"
},
{
"url": "https://example.com/converted/pc/webp/yyy.webp",
"format": "webp",
"type": "pc"
}
]
}
使用示例
# 获取 10 张随机图片 GET /api?count=10 # 获取移动端图片 GET /api?type=pe&count=5 # 直接重定向到图片 GET /api?count=1&return=redirect # 获取纯文本链接 GET /api?count=5&return=text
GET
/image
直接返回随机图片（302 重定向）
使用示例
# 直接获取随机图片
GET /image
# 在 HTML 中使用
<img src="https://your-domain.com/image">
# 在 CSS 中使用
background-image: url('https://your-domain.com/image');
错误码与特性
404
未找到图片资源。
500
服务器内部错误。
设备检测
根据 User-Agent 自动识别 PC 或移动设备。
格式优化
自动返回 WebP 格式，兼顾质量与体积。
零配置
直接访问端点即可使用，无需任何参数。
边缘加速
全球边缘节点就近响应，低延迟分发。