随机壁纸

wallpaperGET
GEThttps://v1.apizero.cn/api/wallpaper

概述

对接 360 公开壁纸库,16 个分类 × 7 种分辨率(含 1920×1080 原图)随机壁纸。 • **16 个分类**:美女 / 风景 / 游戏 / 影视 / 时尚 / 明星 / 汽车 / 萌宠 / 清新 / 体育 / 萌娃 / 军事 / 动漫 / 日历 / 爱情 / 格言 • **7 种分辨率**:1920×1080(原图)/ 1600×900 / 1440×900 / 1366×768 / 1280×800 / 1280×1024 / 1024×768 • **修复源码 BUG**:源码注释默认 1920×1080 但代码默认 1600×900 且 resMap 缺 1920×1080 → 现已用服务 url 字段返回真正 1920×1080 原图 • **修复源码 BUG**:源码 tag 字段返回内部标记(如 `_category_海洋天堂_`)不可读 → 现已拆分 utag 输出为 tags 数组(如 `['海洋天堂','日出东方','松树','海岛']`) • **修复源码 BUG**:服务图片 URL 是 http:// → 现已强制改写为 https://,避免 HTTPS 站点混合内容警告 • **缓存优化**:服务响应按 (cid, start_bucket) 缓存 1h,shuffle 在本地做,**节省 80% 服务请求同时保证随机性** • **典型场景**:登录页背景 / 桌面壁纸应用 / 文章封面图 / 小程序首页轮播

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/wallpaper/raw.md
打开 Markdown

鉴权

匿名每日 200 次、QPS 10;登录用户每日 1000 次、QPS 20(全部免费)。服务响应缓存 1h,命中不计入服务配额。

获取 API Key

请求头

Authorizationstring选填

推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。

风景(默认)

GETURL QUERY·APPLICATION/JSON

默认分类。不传 category 时等同于「风景」。文档示例为真实抓取。

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

categorystring选填

分类中文名,此处固定「风景」

例风景

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "风景",
    "category_id": 9,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p3.qhimg.com/bdr/__85/t012692c21ef013fc43.jpg",
        "id": 2053976,
        "resolution": "1920x1080",
        "tags": [
          "冰天雪地",
          "银装素裹",
          "特写"
        ],
        "tag_text": "冰天雪地 银装素裹 特写"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

美女

GETURL QUERY·APPLICATION/JSON

分类 category=美女。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E7%BE%8E%E5%A5%B3&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「美女」

例美女

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "美女",
    "category_id": 6,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p9.qhimg.com/bdr/__85/t01b4bf715a2ce9246c.jpg",
        "id": 2053413,
        "resolution": "1920x1080",
        "tags": [
          "清纯",
          "花朵",
          "回眸",
          "清秀",
          "气质"
        ],
        "tag_text": "清纯 花朵 回眸 清秀 气质"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

游戏

GETURL QUERY·APPLICATION/JSON

分类 category=游戏。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%B8%B8%E6%88%8F&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「游戏」

例游戏

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "游戏",
    "category_id": 5,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p7.qhimg.com/bdr/__85/t0111ad21b7fa32edb5.jpg",
        "id": 2054119,
        "resolution": "1920x1080",
        "tags": [
          "英雄联盟",
          "LOL",
          "阿木木",
          "茶壶",
          "青花瓷"
        ],
        "tag_text": "英雄联盟 LOL 阿木木 茶壶 青花瓷"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

影视

GETURL QUERY·APPLICATION/JSON

分类 category=影视。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E5%BD%B1%E8%A7%86&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「影视」

例影视

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "影视",
    "category_id": 7,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p6.qhimg.com/bdr/__85/t0140c698b7f2794ec0.jpg",
        "id": 2052615,
        "resolution": "1920x1080",
        "tags": [
          "理想之城",
          "孙俪",
          "赵又廷"
        ],
        "tag_text": "理想之城 孙俪 赵又廷"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

时尚

GETURL QUERY·APPLICATION/JSON

分类 category=时尚。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%97%B6%E5%B0%9A&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「时尚」

例时尚

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "时尚",
    "category_id": 10,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p7.qhimg.com/bdr/__85/t01833fc3a1aa06ab61.jpg",
        "id": 2050525,
        "resolution": "1920x1080",
        "tags": [
          "雾山",
          "迷雾",
          "层层山峦",
          "神秘"
        ],
        "tag_text": "雾山 迷雾 层层山峦 神秘"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

明星

GETURL QUERY·APPLICATION/JSON

分类 category=明星。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%98%8E%E6%98%9F&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「明星」

例明星

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "明星",
    "category_id": 11,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p4.qhimg.com/bdr/__85/t011b028dbb64f8a5a0.jpg",
        "id": 2053849,
        "resolution": "1920x1080",
        "tags": [
          "王一博"
        ],
        "tag_text": "王一博"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

汽车

GETURL QUERY·APPLICATION/JSON

分类 category=汽车。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%B1%BD%E8%BD%A6&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「汽车」

例汽车

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "汽车",
    "category_id": 12,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p6.qhimg.com/bdr/__85/t01405f939d39c35721.jpg",
        "id": 2053357,
        "resolution": "1920x1080",
        "tags": [
          "保时捷",
          "赛车",
          "速度"
        ],
        "tag_text": "保时捷 赛车 速度"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

萌宠

GETURL QUERY·APPLICATION/JSON

分类 category=萌宠。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E8%90%8C%E5%AE%A0&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「萌宠」

例萌宠

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "萌宠",
    "category_id": 14,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p4.qhimg.com/bdr/__85/t019105de7f99749607.jpg",
        "id": 2052489,
        "resolution": "1920x1080",
        "tags": [
          "喵星人",
          "圣诞",
          "布偶猫",
          "可爱"
        ],
        "tag_text": "喵星人 圣诞 布偶猫 可爱"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

清新

GETURL QUERY·APPLICATION/JSON

分类 category=清新。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%B8%85%E6%96%B0&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「清新」

例清新

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "清新",
    "category_id": 15,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p4.qhimg.com/bdr/__85/t01d929493801498326.jpg",
        "id": 2052891,
        "resolution": "1920x1080",
        "tags": [
          "动感水果",
          "草莓"
        ],
        "tag_text": "动感水果 草莓"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

体育

GETURL QUERY·APPLICATION/JSON

分类 category=体育。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E4%BD%93%E8%82%B2&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「体育」

例体育

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "体育",
    "category_id": 16,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p0.qhimg.com/bdr/__85/t0193a46efc0ea1fe39.jpg",
        "id": 2021913,
        "resolution": "1920x1080",
        "tags": [
          "冲浪",
          "夕阳",
          "运动"
        ],
        "tag_text": "冲浪 夕阳 运动"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

萌娃

GETURL QUERY·APPLICATION/JSON

分类 category=萌娃。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E8%90%8C%E5%A8%83&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「萌娃」

例萌娃

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "萌娃",
    "category_id": 18,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p18.qhimg.com/bdr/__85/t017a8c2eb4c2d2aa41.jpg",
        "id": 318290,
        "resolution": "1920x1080",
        "tags": [
          "baby",
          "可爱",
          "宝宝",
          "睡觉"
        ],
        "tag_text": "baby 可爱 宝宝 睡觉"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

军事

GETURL QUERY·APPLICATION/JSON

分类 category=军事。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E5%86%9B%E4%BA%8B&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「军事」

例军事

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "军事",
    "category_id": 22,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p3.qhimg.com/bdr/__85/t01b5dcf68b8219a3d6.jpg",
        "id": 2031603,
        "resolution": "1920x1080",
        "tags": [
          "火箭",
          "长征5",
          "发射",
          "升空"
        ],
        "tag_text": "火箭 长征5 发射 升空"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

动漫

GETURL QUERY·APPLICATION/JSON

分类 category=动漫。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E5%8A%A8%E6%BC%AB&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「动漫」

例动漫

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "动漫",
    "category_id": 26,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p2.qhimg.com/bdr/__85/t01a8b60c45f9e1100a.jpg",
        "id": 2054077,
        "resolution": "1920x1080",
        "tags": [
          "沃尔沃",
          "城市夜晚",
          "路灯",
          "汽车"
        ],
        "tag_text": "沃尔沃 城市夜晚 路灯 汽车"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

日历

GETURL QUERY·APPLICATION/JSON

分类 category=日历。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%97%A5%E5%8E%86&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「日历」

例日历

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "日历",
    "category_id": 29,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p7.qhimg.com/bdr/__85/t01546eb1987c276b70.jpg",
        "id": 2052724,
        "resolution": "1920x1080",
        "tags": [
          "九月",
          "月历"
        ],
        "tag_text": "九月 月历"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

爱情

GETURL QUERY·APPLICATION/JSON

分类 category=爱情。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E7%88%B1%E6%83%85&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「爱情」

例爱情

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "爱情",
    "category_id": 30,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p18.qhimg.com/bdr/__85/t01b909cb1edc572c54.jpg",
        "id": 323808,
        "resolution": "1920x1080",
        "tags": [
          "爱情",
          "唯美温馨"
        ],
        "tag_text": "爱情 唯美温馨"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

格言

GETURL QUERY·APPLICATION/JSON

分类 category=格言。文档示例为真实抓取。

https://v1.apizero.cn/api/wallpaper?category=%E6%A0%BC%E8%A8%80&resolution=1920x1080&count=1

categorystring选填

分类中文名,此处固定「格言」

例格言

resolutionstring选填

分辨率:1920x1080 / 1600x900 / 1440x900 / 1366x768 / 1280x800 / 1280x1024 / 1024x768

例1920x1080

countinteger选填

返回数量 1–20,默认 1

例1

返回结果

categorystring

分类中文名

category_idinteger

分类 ID

resolutionstring

实际分辨率

countinteger

实际返回张数

requestedinteger

请求张数

imagesarray

壁纸列表:url / id / resolution / tags / tag_text

urlstring

地址

idnumber

id

resolutionstring

分辨率

tagsarray

tags

images[].tags[]string

images[].tags 的一项

tag_textstring

tag_text

tipsstring

品牌提示(所有接口统一返回):极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "category": "格言",
    "category_id": 35,
    "resolution": "1920x1080",
    "count": 1,
    "requested": 1,
    "images": [
      {
        "url": "https://p8.qhimg.com/bdr/__85/t019ca1e86cd942277b.jpg",
        "id": 2024094,
        "resolution": "1920x1080",
        "tags": [
          "毕业季",
          "那些年",
          "再见"
        ],
        "tag_text": "毕业季  那些年 再见"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

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

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
完全免费
QPS 限制
QPS 3
登录免费额度
10000 次(已认证)
匿名每日额度
2000 次(无 API Key)
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-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

免责声明

本接口对接 360 公开壁纸库,所有图片版权归 360 及原作者所有。本平台仅做缓存代理,不保证服务 24h 稳定可用。请勿将壁纸用于商业传播;用作个人桌面、社交分享头像/封面等场景属合理使用。「美女」分类内容偏写真风格,部分上下文不适合所有用户。