首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >通用图片搜索API:百度源免费接口教程

通用图片搜索API:百度源免费接口教程

原创
作者头像
用户9840656
发布2025-07-10 10:37:17
发布2025-07-10 10:37:17
45600
代码可运行
举报
运行总次数:0
代码可运行

本文介绍一款基于百度图片搜索的免费API接口,由接口盒子提供,可帮助开发者快速实现关键词图片搜索功能。


接口基本信息

  • 请求地址​:https://cn.apihz.cn/api/img/apihzimgbaidu.php
  • 请求方式​:GET 或 POST
  • 认证机制​:用户ID + 通讯秘钥(需注册获取)
  • 数据来源​:百度图片搜索结果

请求参数说明

参数名

必填

说明

id

用户中心的数字ID

key

用户中心通讯秘钥

words

搜索关键词(≤10汉字)

page

页码(默认1)

limit

返回数量(1-100,默认1)

type

返回源类型:1=百度预览图(默认),2=原始图(可能失效)


返回参数说明

代码语言:javascript
代码运行次数:0
运行
复制
json复制{
  "code": 200,          // 状态码(200成功,400错误)
  "msg": "",            // 错误提示信息
  "res": [],            // 图片地址数组
  "page": "1",          // 当前页码
  "maxpage": 87,        // 最大页码
  "count": 1725         // 结果总数
}

调用示例(PHP)

代码语言:javascript
代码运行次数:0
运行
复制
php复制<?php
$apiUrl = "https://cn.apihz.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)

代码语言:javascript
代码运行次数:0
运行
复制
python运行复制import requests
from urllib.parse import quote

api_url = "https://cn.apihz.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'])

注意事项

  1. 获取认证信息​:
    • 注册接口盒子账号
    • 在用户中心获取专属的 idkey
  2. 频次限制​:
    • 公共ID共享频次限制(易触发限制)
    • 私有ID独享每分钟调用频次
    • 每日调用总量无上限
  3. 关键词要求​:
    • 长度不超过10个汉字
    • 必须进行URL编码(Python用urllib.parse.quote,PHP用urlencode
  4. 图片源选择​:
    • type=1:返回稳定的百度预览图(推荐)
    • type=2:返回原始图片地址(可能失效)

技术原理

该接口通过模拟百度图片搜索的请求过程,对返回结果进行清洗和格式化处理,最终输出结构化的JSON数据。采用百度官方数据源保证了图片资源的丰富性和时效性。

官方文档参考:apihz.cn接口文档

通过这个免费API,开发者可快速实现图片搜索功能,适用于内容聚合、素材库建设、AI训练数据采集等场景。建议使用私有认证信息以保证服务稳定性。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口基本信息
  • 请求参数说明
  • 返回参数说明
  • 调用示例(PHP)
  • 调用示例(Python)
  • 注意事项
  • 技术原理
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档