PicAPI 壁纸接口开放接入 — 简单好用的免费壁纸服务

``` # 随机壁纸（每次刷新不同）

# 指定尺寸（自动居中裁剪） # 获取列表 GET https://pic.rmzdb.cloud/list ```

---

##

接口文档

### 1. 获取随机壁纸

``` GET / ```

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | w | number | 否 | 宽度（px），默认原图 | | h | number | 否 | 高度（px），默认原图 |

示例：

```html ```

---

### 2. 壁纸列表

``` GET /list ```

返回 JSON，包含所有壁纸文件名、大小、最后修改时间。

```json { "total": 20, "files": [ { "name": "wall-01.jpg", "size": 372202, "sizeStr": "363.5KB", "lastModifiedStr": "2026-06-07 20:04" } ] } ```

可直接遍历列表循环展示所有壁纸。

---

### 3. 管理接口（需 API Key）

| 接口 | 方法 | 说明 | |------|------|------| | /upload | POST | 上传壁纸 | | /{filename} | DELETE | 删除壁纸 | | /download | POST | 从 URL 下载 |

管理接口需要在请求头携带 X-API-Key，API Key 需要向管理员申请。

---

##

适用场景

- 个人博客/网站背景 - 每天自动换背景不重复 - 桌面壁纸应用 - 定时拉取新壁纸到本地切换 - 导航页/起始页 - 精美背景提升页面质感 - 图床/CDN 测试 - 小体量图片，适合调试 - 前端练习项目 - 基于免费 API 开发图片类 Demo

---

##

调用示例

### HTML 展示

```html

```

### 命令行下载

```bash # 下载随机壁纸到本地 curl -O https://pic.rmzdb.cloud/

# 下载指定壁纸 curl -O https://pic.rmzdb.cloud/wall-01.jpg

# 获取列表 curl -s https://pic.rmzdb.cloud/list | python3 -m json.tool ```

### Python 脚本

```python import requests import random

# 获取列表 r = requests.get("https://pic.rmzdb.cloud/list") files = r.json()["files"]

# 随机下载一张 pick = random.choice(files) img = requests.get(f"https://pic.rmzdb.cloud/{pick['name']}") with open(pick['name'], 'wb') as f: f.write(img.content)

print(f"已下载: {pick['name']} ({pick['sizeStr']})") ```

---

##

注意事项

- 所有壁纸均为 1920x1080 高清图片，JPG/PNG 格式 - 公开接口（随机/列表）无需任何授权，放心调用 - 管理接口（上传/删除）需要 API Key，确保安全 - URL 下载做了 SSRF 防护，禁止内网/本地地址 - 上传接口做了文件魔数校验，只接受真实图片 - 限速策略：单 IP 每秒最多 10 次请求 - 服务由 Spring Boot 3.2.5 驱动，Nginx 代理，SSL 加密传输 - 所有响应头包含安全防护（nosniff、XSS 保护等）

> 壁纸库持续更新！如果想上传自己收藏的图片或申请 API Key，欢迎联系站长。

---

**服务地址：** https://pic.rmzdb.cloud/ **管理后台：** https://pic.rmzdb.cloud/admin/ **博客链接：** 本文永久链接，欢迎转发分享

本文为作者原创，未经授权禁止转载、洗稿、搬运。如需引用请保留原文链接