/wallpaper/api

Bing 壁纸开放 API

无需密钥，支持跨域调用。服务实时读取上游，不使用 KV、数据库或持久化缓存。

中文EN

REQUEST BUILDER

URL 生成器

选择接口与参数，即时生成可直接调用的完整地址。

接口
地区版本
输出尺寸
Bing 源日期可选；输入 YYYYMMDD 或 YYYY-MM-DD，留空时使用今日壁纸
图片响应
生成结果
打开
https://api.wallpaper.lkztools.top/api/wallpaper?mkt=zh-CN&resolution=UHD
GET

今日元数据

实时返回今日壁纸信息和全部可用尺寸的图片地址；响应为 JSON，不是图片。

https://api.wallpaper.lkztools.top/api/today?mkt=zh-CN&resolution=UHD打开

查询参数

mkt
String
必填否
默认值zh-CN
地区版本：zh-CN / en-US / ja-JP / en-GB
resolution
String
必填否
默认值UHD
输出尺寸：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

请求示例

curl "https://api.wallpaper.lkztools.top/api/today?mkt=zh-CN&resolution=UHD"

响应示例

{
  "date": "20260809",
  "homepageDate": "20260810",
  "market": "zh-CN",
  "title": "Wallpaper title",
  "source": "bing",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD",
  "images": { "UHD": "https://www.bing.com/th?id=..." }
}
GET

日期元数据

按 Bing startdate 查询历史元数据；homepageDate 是对应市场首页展示日期。

https://api.wallpaper.lkztools.top/api/metadata?mkt=zh-CN&date=2026-06-17&resolution=UHD打开

查询参数

date
String
必填是
默认值—
Bing startdate，接受 YYYYMMDD 或 YYYY-MM-DD；留空时使用今日壁纸
mkt
String
必填否
默认值zh-CN
地区版本：zh-CN / en-US / ja-JP / en-GB
resolution
String
必填否
默认值1920x1080
输出尺寸：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

请求示例

curl "https://api.wallpaper.lkztools.top/api/metadata?mkt=zh-CN&date=2026-06-17&resolution=UHD"

响应示例

{
  "date": "20260617",
  "homepageDate": "20260618",
  "market": "zh-CN",
  "title": "Wallpaper title",
  "copyright": "Wallpaper copyright",
  "source": "community-archive",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD",
  "images": { "UHD": "https://www.bing.com/th?id=..." }
}
GET

壁纸图片

直接用于浏览器、img 标签或壁纸客户端；默认 302 跳转，proxy=1 时返回图片本体。

https://api.wallpaper.lkztools.top/api/wallpaper?mkt=zh-CN&resolution=UHD打开

查询参数

mkt
String
必填否
默认值zh-CN
地区版本：zh-CN / en-US / ja-JP / en-GB
resolution
String
必填否
默认值1920x1080
输出尺寸：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280
proxy
Boolean
必填否
默认值0
设为 1 时代理返回图片本体；默认 302 跳转
date
String
必填否
默认值today
Bing startdate，接受 YYYYMMDD 或 YYYY-MM-DD；留空时使用今日壁纸

请求示例

curl -L "https://api.wallpaper.lkztools.top/api/wallpaper?mkt=zh-CN&resolution=UHD&proxy=1" --output wallpaper.jpg

响应示例

proxy=0
302 Found
Location: https://www.bing.com/th?id=...

proxy=1
200 OK
Content-Type: image/jpeg
GET

历史图片

按月份聚合日期元数据。中国区约覆盖至 2023-02，美国区约覆盖至 2021-02，日本与英国区约覆盖至 2022-04。

https://lkztools.top/api/wallpaper-history?mkt=zh-CN&month=2026-08打开

查询参数

mkt
String
必填否
默认值zh-CN
地区版本：zh-CN / en-US / ja-JP / en-GB
month
String
必填否
默认值latest
月份，格式为 YYYY-MM

请求示例

curl "https://lkztools.top/api/wallpaper-history?mkt=zh-CN&month=2026-08"

响应示例

{
  "month": "2026-08",
  "months": ["2026-08", "2026-07"],
  "items": [
    {
      "date": "2026-08-10",
      "sourceDate": "20260809",
      "title": "Wallpaper title",
      "copyright": "Wallpaper copyright",
      "source": "bing",
      "url": "https://api.wallpaper.lkztools.top/api/wallpaper?date=20260809&resolution=UHD"
    }
  ]
}
GET

随机壁纸

从 Bing 官方最近 8 张图片中随机返回一张元数据。

https://api.wallpaper.lkztools.top/api/random?mkt=zh-CN&resolution=UHD打开

查询参数

mkt
String
必填否
默认值zh-CN
地区版本：zh-CN / en-US / ja-JP / en-GB
resolution
String
必填否
默认值1920x1080
输出尺寸：UHD / 1920x1200 / 1920x1080 / 1366x768 / 1280x720 / 1024x768 / 800x600 / 800x480 / 768x1280 / 720x1280

请求示例

curl "https://api.wallpaper.lkztools.top/api/random?mkt=zh-CN&resolution=UHD"

响应示例

{
  "date": "20260809",
  "homepageDate": "20260810",
  "market": "zh-CN",
  "title": "Wallpaper title",
  "source": "bing",
  "url": "https://www.bing.com/th?id=...",
  "resolution": "UHD"
}