OnePic API

🚀

服务状态

实时监控 API 服务运行状态

✓

系统状态

正常运行

99.9%

服务可用性

📡

API 版本

v3.0

🖼

图片格式

WebP

📱

设备支持

PC / 移动端

☁

部署平台

EdgeOne Pages

API 测试

点击下方按钮测试随机图片获取功能

🎨

图库浏览

浏览所有可用的图片资源

🖼加载中...

1 / 1

📄

API 文档

完整的接口使用指南与参考

OnePic API 是一个轻量级的随机图片服务，基于 EdgeOne Pages 边缘函数实现。支持 WebP 图片格式，自动适配不同设备类型，为 Web 应用提供高性能、低延迟的图片分发能力。

1API 端点

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');

2错误码

404

未找到图片资源

500

服务器内部错误

3自动检测机制

📱
设备类型检测 — 根据 User-Agent 自动识别 PC 或移动设备
🖼
图片格式优化 — 自动返回 WebP 格式，兼顾质量与体积
🚀
零配置使用 — 直接访问 /api 或 /image，无需任何参数