BWPAPI 2.0 Beta

BWPAPI 2.0 Beta（BingWallpaper API）是一个正在持续更新中的接口，旨在为用户提供一系列 获取必应壁纸 的新方式。

如果你在使用过程中遇到任何疑问，欢迎来到 BingWallpaper API 节点讨论。

API 接口

所有 2.0 的 API 接口都位于下面的这个前缀下：

https://wallpaperbar.com/api/

接口持续更新，用爱发电，请勿滥用。

API Rate Limit

默认情况下，每个 IP 每小时可以发起的 API 请求数被限制在 600 次。你可以在 API 返回结果的 HTTP 头部找到 Rate Limit 信息：

X-Rate-Limit-Limit: 600

X-Rate-Limit-Reset: 1409479200

X-Rate-Limit-Remaining: 116

对于能够被浏览器缓存的 API 请求，只有第一次请求时，才会消耗 Rate Limit 配额。后续的相同请求会直接从浏览器缓存中获取结果，不会再次消耗配额。

下面是具体的接口访问信息。

今日必应壁纸

可直接输出今日必应壁纸图片，默认参数：&setmkt=访问者地区，&size=1920x1080

可选参数：

• setmkt - 可指定地区：cn，us，gb，jp，de，fr，br，in，it，es，ca，au
• size - 支持的值：uhd，qhd，fhd，mbl，mrk，1920x1200，1920x1080，1366x768，1280x768，1024x768，800x600，800x480，768x1280，720x1280，640x480，480x800，400x240，320x240，240x320

完整例子：

随机必应壁纸

可随机输出一张必应壁纸图片，默认参数：&size=1920x1080

可选参数：

• setmkt - 可指定地区：cn，us，gb，jp，de，fr，br，in，it，es，ca，au
• size - 支持的值：uhd，qhd，fhd，mbl，mrk，1920x1200，1920x1080，1366x768，1280x768，1024x768，800x600，800x480，768x1280，720x1280，640x480，480x800，400x240，320x240，240x320

完整例子：

指定日期必的应壁纸

可输出指定日期的必应壁纸图片，默认参数：&setmkt=访问者地区，&size=1920x1080

可选参数：

• date - 格式：20241201（必须 yyyyMMdd 格式）
• setmkt - 可指定地区：cn，us，gb，jp，de，fr，br，in，it，es，ca，au
• size - 支持的值：uhd，qhd，fhd，mbl，mrk，1920x1200，1920x1080，1366x768，1280x768，1024x768，800x600，800x480，768x1280，720x1280，640x480，480x800，400x240，320x240，240x320

完整例子：

扩展用法

1.自定义 Bing壁纸 图片宽高

使用方法：

• 将参数拼接至 API 接口的URL末尾
• 可单独定义宽或高：&w=* or &h=*，也可组合定义宽高：&w=*&h=*。

注意：

• 自定义宽高（&w and &h）与 &size 不能同时使用，请选择其中一种方式。

2.跳转至 Bing壁纸 图片直链

使用方法：

• 将参数拼接至 API 接口的URL末尾
• 支持所有 API 接口调用。