Edge Powered · 全球加速

随机图片
边缘分发

基于边缘计算的高性能图片 API 服务，为 Web 应用提供低延迟、高质量的随机图片分发能力

查看文档

99.9%

服务可用性

Enterprise grade

v3.0

API 版本

为速度而生

构建世界级产品所需的一切能力，协同工作，无缝衔接

⚡

边缘计算

基于边缘函数，全球节点就近响应，零延迟缓存，运行时无额外请求

📱

设备适配

自动检测客户端设备类型，智能返回 PC 端或移动端适配图片

🖼

WebP 优化

采用现代 WebP 格式，体积更小、质量更高，兼顾性能与体验

🎲

随机分发

从图片池随机选择，支持单张或批量获取，JSON/重定向/文本多种返回

🛡

多平台部署

同时支持腾讯云 EdgeOne Pages 和阿里云 ESA，灵活选择部署平台

🚀

零配置使用

直接访问 /api 或 /image 即可获取图片，无需复杂参数配置

在线体验

点击按钮获取一张随机图片，感受边缘加速的力量

Process

三步开始使用

几分钟即可完成接入，无需复杂配置

1

调用接口

访问 /api 或 /image 端点，系统自动检测设备类型

2

边缘响应

就近边缘节点处理请求，随机选择图片并返回

3

集成使用

在 HTML、CSS 或应用中直接引用返回的图片 URL

Gallery

图片图库

浏览所有可用的图片资源，支持 PC 端和移动端切换

🎨

浏览图库

点击图片查看大图

加载中... 设备类型：PC 端

1 / 1

Documentation

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": 10,
  "type": "pc",
  "format": "webp",
  "images": [
    {
      "url": "https://example.com/converted/pc/webp/xxx.webp",
      "format": "webp",
      "type": "pc"
    }
  ]
}

使用示例

HTTP

# 获取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 重定向）

使用示例

HTTP / HTML / CSS

# 直接获取随机图片
GET /image

# 在 HTML 中使用
<img src="https://your-domain.com/image" />

# 在 CSS 中使用
background-image: url('https://your-domain.com/image');

Reference

错误码与特性

404

未找到图片资源

500

服务器内部错误

📱 设备检测

根据 User-Agent 自动识别 PC 或移动设备

🖼 格式优化

自动返回 WebP 格式，兼顾质量与体积

🚀 零配置

直接访问端点即可使用，无需任何参数

⚡ 边缘加速

全球边缘节点就近响应，低延迟分发

随机图片边缘分发