使用Google Images Search API仅获灰度图及无结果问题求助

问题背景 #

• 环境：Python 3.11.4、PyCharm 2023.2（社区版）
• 问题1：调用Google Images Search API时，即使设置imageColorType: 'color'，下载的仍为灰度图
• 问题2：搜索关键词"cat meme"时无任何图片返回
• 原代码：

def get_image(image_keyword=""):

    from dotenv import load_dotenv
    import os
    from google_images_search import GoogleImagesSearch
    if not os.path.exists('images/'):
        os.mkdir('images/')
    spath = 'images/'
    if os.path.exists(".env"):
        load_dotenv()
    else:
        print(".env file missing, please create one with your API and CX")
    dk = os.environ.get('DEVELOPER_KEY')
    cx = os.environ.get('CX')

    gis = GoogleImagesSearch(dk, cx)
    _search_params = {
        'q': image_keyword,
        'num': 1,
        'imageColorType': 'color'
        }
    gis.search(search_params=_search_params, path_to_dir=spath)


get_image("cat")

解决方案 #

1. 修正图片颜色筛选参数 #

google_images_search库的参数需与Google Custom Search API官方定义一致，正确参数名为imgColorType而非imageColorType。修改后的搜索参数：

_search_params = {
    'q': image_keyword,
    'num': 1,
    'imgColorType': 'color'  # 修正参数名
}

该参数有效值包括：color（强制彩色）、gray（灰度）、mono（单色），设置为color后将只返回彩色图片。

2. 解决"cat meme"无结果问题 #

检查自定义搜索引擎（CX）配置

• 登录Google Custom Search控制台，确认对应CX的搜索引擎已开启图片搜索功能
• 移除不必要的站点限制（若设置了仅搜索特定站点），或添加包含meme内容的站点（如reddit.com、imgflip.com）
• 确保搜索类型设置为"图片"或"所有类型"

调整搜索参数

• 添加safe: 'off'参数（meme内容可能被标记为非安全内容）：

_search_params = {
    'q': image_keyword,
    'num': 1,
    'imgColorType': 'color',
    'safe': 'off'
}

• 尝试增大num参数（如设为5），避免因单条结果不存在导致无返回
• 验证API密钥（DEVELOPER_KEY）是否启用了Custom Search API且有剩余配额

代码优化建议 #

• 将模块导入移至函数外部，避免重复导入：

from dotenv import load_dotenv
import os
from google_images_search import GoogleImagesSearch

def get_image(image_keyword=""):
    # 原函数逻辑...

• 添加异常捕获，便于排查API调用错误：

try:
    gis.search(search_params=_search_params, path_to_dir=spath)
except Exception as e:
    print(f"API调用失败: {str(e)}")

内容的提问来源于stack exchange，提问作者Karen Tabar