随机壁纸 API 接入文档wallpaper

匿名每日 200 次、QPS 10；登录用户每日 1000 次、QPS 20（全部免费）。上游响应缓存 1h，命中不计入上游配额。

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/wallpaper?category=%E9%A3%8E%E6%99%AF&resolution=1920x1080&count=5&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/wallpaper",
    params={
    "category": "风景",
    "resolution": "1920x1080",
    "count": "5",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "category": "风景",
  "resolution": "1920x1080",
  "count": "5",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/wallpaper?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/wallpaper", nil)
	q := req.URL.Query()
	q.Set("category", "风景")
	q.Set("resolution", "1920x1080")
	q.Set("count", "5")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/wallpaper?" . http_build_query([
    "category" => "风景",
    "resolution" => "1920x1080",
    "count" => "5",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "code": 0,
    "msg": "成功",
    "data": {
        "category": "风景",
        "category_id": 9,
        "resolution": "1920x1080",
        "count": 2,
        "requested": 2,
        "images": [
            {
                "url": "https:\/\/p2.qhimg.com\/bdr\/__85\/t019ca75cd449be50c1.jpg",
                "id": 2054209,
                "resolution": "1920x1080",
                "tags": [
                    "海洋天堂",
                    "日出东方",
                    "松树",
                    "海岛"
                ],
                "tag_text": "海洋天堂 日出东方 松树 海岛"
            },
            {
                "url": "https:\/\/p2.qhimg.com\/bdr\/__85\/t021abc.jpg",
                "id": 2054210,
                "resolution": "1920x1080",
                "tags": [
                    "雪山",
                    "日出",
                    "云海"
                ],
                "tag_text": "雪山 日出 云海"
            }
        ]
    },
    "request_id": "abc123def456"
}

• 1.0.0(2026-05-07)
  • 首次上线，对接 360 壁纸库 16 分类 × 7 分辨率
  • 修复源码 BUG：默认分辨率从「1600×900」改为真正的 1920×1080 原图（用上游 url 字段）
  • 修复源码 BUG：tag 字段从内部标记（_category_xxx_）改为可读 utag 拆分数组
  • 修复源码 BUG：图片 URL 强制改写 http:// → https://，避免 HTTPS 站点混合内容警告
  • 新增 7 种分辨率（含 1920×1080 原图），共 7 档可选
  • 新增 images[].id 字段，便于业务侧做去重 / 收藏
  • 上游响应按 (cid, start_bucket=10) 桶化缓存 1h，节省 80% 上游请求
  • shuffle 始终在本地做，缓存命中也保证随机性
  • 错误细分：上游 HTTP 错 / errno!=0 / 列表为空 / 分类无该分辨率 → 不同 code