随机图片
上新随机图片:转发 360 壁纸搜索并返回直链(版权归原作者)
随机图片:按关键词搜索 360 壁纸/插画素材,从结果中随机抽取可直链的图片地址。
【版权与计费说明】
- 数据来源于 360 壁纸,版权归原作者所有。
- 本接口费用为网关转发费(鉴权、计次、转发),不含图片版权授权费用。
- 返回的图片直链仅供学习、测试、联调占位等非商用场景参考;商用请自行向权利人取得授权。
- 本站不转存、不托管图片文件,不对图片内容与授权状态作担保。
参数:
- q / keyword:搜索关键词(可选;不传则从内置主题中随机,如风景壁纸、动漫壁纸等)
- count:返回张数,1~10,默认 1
- page:指定上游页码(可选;不传则随机翻页,增强随机性)
返回:
- data.images:图片列表(每项含 id / title / url / labels,可选 size、creator)
- data.source:数据来源标识(360壁纸)
- data.notice:版权与计费说明原文
【版权与计费说明】
- 数据来源于 360 壁纸,版权归原作者所有。
- 本接口费用为网关转发费(鉴权、计次、转发),不含图片版权授权费用。
- 返回的图片直链仅供学习、测试、联调占位等非商用场景参考;商用请自行向权利人取得授权。
- 本站不转存、不托管图片文件,不对图片内容与授权状态作担保。
参数:
- q / keyword:搜索关键词(可选;不传则从内置主题中随机,如风景壁纸、动漫壁纸等)
- count:返回张数,1~10,默认 1
- page:指定上游页码(可选;不传则随机翻页,增强随机性)
返回:
- data.images:图片列表(每项含 id / title / url / labels,可选 size、creator)
- data.source:数据来源标识(360壁纸)
- data.notice:版权与计费说明原文
调用地址:https://api.ynlskj.com.cn/gateway/randimg
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
q | Body JSON | 否 | 搜索关键词。也可用 keyword / kw。不传则从内置主题随机 |
count | Body JSON | 否 | 返回张数,1–10,默认 1。超过会返回错误 |
page | Body JSON | 否 | 指定上游页码;不传则随机翻页增强随机性 |
X-API-Key | Header | 是 | 你的 API Key |
请求示例
| 场景 | Body 示例 |
|---|---|
| 默认一张 | {} 或不传参数(关键词随机) |
| 指定关键词 | {"q":"风景壁纸","count":2} |
| 超量(会报错) | {"count":11} → count 最多 10 |
版权与计费:数据来源于 360 壁纸,版权归原作者所有;本接口费用为网关转发费,不含图片版权授权。商用请自行取得授权。本站不转存图片。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.q | 实际使用的搜索关键词 |
data.page | 本次抽取的上游页码 |
data.count | 返回张数(与 images 长度一致) |
data.images | 图片数组。每项含 id、title、url、labels;可选 size、creator |
data.source | 数据来源:360壁纸 |
data.notice | 版权与计费说明:版权归原作者;费用为网关转发费;商用请自行取得授权 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/randimg');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"q": "风景壁纸",
"count": 2
}',
]);
echo curl_exec($ch);
请求参数演示
{"q":"风景壁纸","count":2}
响应演示
{"ret":"ok","data":{"q":"风景壁纸","page":3,"count":2,"images":[{"id":110013,"title":"示例壁纸标题","url":"https://browser6.qhimg.com/t01xxxxxxxx.jpg","labels":["风景","壁纸"],"size":"1920x1080","creator":"示例作者"},{"id":110014,"title":"另一张示例","url":"https://browser6.qhimg.com/t01yyyyyyyy.jpg","labels":["自然"],"creator":"示例作者2"}],"source":"360壁纸","notice":"数据来源于 360 壁纸,版权归原作者所有;本接口费用为网关转发费,不含图片版权授权。商用请自行取得授权。"}}