准备工作：申请API Key与理解基础规则

在使用百度图片搜索API之前，你需要先拥有一个百度开发者账号并创建应用。访问百度AI开放平台（console.bce.baidu.com），在“图像搜索”或“内容审核”相关产品中申请API Key。通常需要填写应用名称、选择服务类型，审核通过后你会获得一个API Key和Secret Key。这两个凭证是后续每次调用的通行证，务必妥善保存。

另外，百度API有正常的调用频率限制（QPS）和每日配额上限。对于个人学习或轻度使用，免费额度一般足够；如果需要批量获取大量图片，建议规划好请求间隔，避免触发临时封禁。

核心流程：构造请求URL与解析返回数据

百度图片搜索的API接口通常基于HTTP GET请求。你需要将关键词（如“湖南岳阳楼”“岳阳洞庭湖夕阳”）、每页返回数量（如20或30）、分页页码等参数拼接在请求地址中。典型请求示例如下：

• 基础URL：类似于 https://aip.baidubce.com/rest/2.0/image-search/v1/xxx（具体接口名需参照最新文档）
• 关键参数：query（搜索词）、pn（起始位置，用于翻页）、rn（返回图片数量）、access_token（通过API Key和Secret Key临时获取）
• 返回格式：JSON结构，其中 data 数组里每项包含图片URL、标题、来源等信息。

获取图片URL后，你可以通过编程方式（如Python的requests库）逐一下载。建议在下载时使用 time.sleep(0.5) 等间隔，模拟人工操作，降低服务器压力。

实战步骤：从0构建批量获取脚本

1. 获取access_token：使用你的API Key和Secret Key调用百度OAuth接口，接收返回的token字符串。此token通常有效期为一个月，可缓存复用。
2. 设置搜索关键词与页数：例如搜索“岳阳楼雪景”，设定每页30张，共获取10页（300张）。注意百度限制最大可见页数，一般不超过50页。
3. 循环发送请求并提取URL：每轮循环中，改变 pn 参数（如依次为0, 30, 60…），解析返回的JSON，将所有 thumbURL 或 middleURL 存入列表。
4. 去重与过滤：部分结果可能重复或为略缩图。你可以根据URL后缀格式（如.jpg、.png）、尺寸字段或域名白名单进行过滤，保留高清原图。
5. 下载到本地目录：使用 urllib.request.urlretrieve 或 requests.get(url).content 写入文件。文件名建议用序号+关键词拼接，方便管理。

常见问题与优化建议

• 返回结果为空或不相关：检查关键词是否含特殊字符，尝试改用更通用的词组（如“岳阳”代替“岳阳市巴陵广场”）。也可在参数中加入 tag 筛选类别。
• 请求超时或403错误：确认access_token未过期；检查QPS是否超限；适当延长超时时间（如设置 timeout=10）。
• 图片版权提示：批量下载的图片仅建议用于个人学习、素材收集或非商业用途。如需商用，请核实图片来源网站的授权声明，或通过百度开放平台的授权图片接口获取合法资源。

额外技巧：提高爬取效率

如果你希望一次性获取上千张图片，可以尝试多线程或异步IO。但需要注意百度API同一账户的并发限制，推荐使用 concurrent.futures.ThreadPoolExecutor 控制线程数在5个以内，并加入随机等待时间（0.2~1秒），模拟自然浏览行为。此外，对于大量相同关键词的请求，可预先整理一个词库列表（如不同季节、不同角度的岳阳地标），循环调用，丰富最终素材的多样性。

最后，记得定期检查百度开放平台的API更新公告，接口参数或策略可能会微调。按照上述思路，你完全可以搭建一个稳定、实用的岳阳图片批量获取工具，为设计、资料整理或本地化内容创作提供素材支持。

准备工作：申请API Key与理解基础规则

在使用百度图片搜索API之前，你需要先拥有一个百度开发者账号并创建应用。访问百度AI开放平台（console.bce.baidu.com），在“图像搜索”或“内容审核”相关产品中申请API Key。通常需要填写应用名称、选择服务类型，审核通过后你会获得一个API Key和Secret Key。这两个凭证是后续每次调用的通行证，务必妥善保存。

另外，百度API有正常的调用频率限制（QPS）和每日配额上限。对于个人学习或轻度使用，免费额度一般足够；如果需要批量获取大量图片，建议规划好请求间隔，避免触发临时封禁。

核心流程：构造请求URL与解析返回数据

百度图片搜索的API接口通常基于HTTP GET请求。你需要将关键词（如“湖南岳阳楼”“岳阳洞庭湖夕阳”）、每页返回数量（如20或30）、分页页码等参数拼接在请求地址中。典型请求示例如下：

• 基础URL：类似于 https://aip.baidubce.com/rest/2.0/image-search/v1/xxx（具体接口名需参照最新文档）
• 关键参数：query（搜索词）、pn（起始位置，用于翻页）、rn（返回图片数量）、access_token（通过API Key和Secret Key临时获取）
• 返回格式：JSON结构，其中 data 数组里每项包含图片URL、标题、来源等信息。

获取图片URL后，你可以通过编程方式（如Python的requests库）逐一下载。建议在下载时使用 time.sleep(0.5) 等间隔，模拟人工操作，降低服务器压力。

实战步骤：从0构建批量获取脚本

1. 获取access_token：使用你的API Key和Secret Key调用百度OAuth接口，接收返回的token字符串。此token通常有效期为一个月，可缓存复用。
2. 设置搜索关键词与页数：例如搜索“岳阳楼雪景”，设定每页30张，共获取10页（300张）。注意百度限制最大可见页数，一般不超过50页。
3. 循环发送请求并提取URL：每轮循环中，改变 pn 参数（如依次为0, 30, 60…），解析返回的JSON，将所有 thumbURL 或 middleURL 存入列表。
4. 去重与过滤：部分结果可能重复或为略缩图。你可以根据URL后缀格式（如.jpg、.png）、尺寸字段或域名白名单进行过滤，保留高清原图。
5. 下载到本地目录：使用 urllib.request.urlretrieve 或 requests.get(url).content 写入文件。文件名建议用序号+关键词拼接，方便管理。

常见问题与优化建议

• 返回结果为空或不相关：检查关键词是否含特殊字符，尝试改用更通用的词组（如“岳阳”代替“岳阳市巴陵广场”）。也可在参数中加入 tag 筛选类别。
• 请求超时或403错误：确认access_token未过期；检查QPS是否超限；适当延长超时时间（如设置 timeout=10）。
• 图片版权提示：批量下载的图片仅建议用于个人学习、素材收集或非商业用途。如需商用，请核实图片来源网站的授权声明，或通过百度开放平台的授权图片接口获取合法资源。

额外技巧：提高爬取效率

如果你希望一次性获取上千张图片，可以尝试多线程或异步IO。但需要注意百度API同一账户的并发限制，推荐使用 concurrent.futures.ThreadPoolExecutor 控制线程数在5个以内，并加入随机等待时间（0.2~1秒），模拟自然浏览行为。此外，对于大量相同关键词的请求，可预先整理一个词库列表（如不同季节、不同角度的岳阳地标），循环调用，丰富最终素材的多样性。

最后，记得定期检查百度开放平台的API更新公告，接口参数或策略可能会微调。按照上述思路，你完全可以搭建一个稳定、实用的岳阳图片批量获取工具，为设计、资料整理或本地化内容创作提供素材支持。