用途:通过 Brave Search API 搜索图片,适合需要按主题查找图片、照片或视觉内容的场景。
主要能力:调用图片搜索接口,返回图片标题、完整图片 URL、缩略图 URL、来源网站及宽高尺寸等字段。支持参数 q(必填,需 URL 编码)、count(1-100,默认 20)、country(两位国家代码,如 US、DE、IL)、search_lang(语言代码,如 en、de、he)、safesearch(off、moderate、strict,默认 moderate)。
使用方式:以 curl 调用接口,并在请求头中携带 API 密钥:
curl -s "https://api.search.brave.com/res/v1/images/search?q=QUERY&count=COUNT"
-H "X-Subscription-Token: $BRAVE_API_KEY"
结果解析:results[].title 为图片标题,results[].properties.url 为完整图片地址,results[].thumbnail.src 为缩略图地址,results[].source 为来源网站,results[].properties.width/height 为尺寸。
呈现建议:直接把图片发给用户而非仅列 URL;完整图用 properties.url,缩略图用 thumbnail.src;以标题作为说明文字;若结果多于展示数量,应告知用户,例如“找到 20 张图片,展示 3 张,是否查看更多”。
限制:查询字符串需 URL 编码(空格转 %20);API 密钥从环境变量 $BRAVE_API_KEY 读取;需遵守订阅层级对应的速率限制。其余收费、价格与平台细节暂未提供。