Brave 图片搜索

通过 Brave Search 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—— 完整图片URL
• results[].thumbnail.src—— 缩略图URL
• results[].source—— 来源网站
• results[].properties.width/height—— 尺寸

示例

搜索以色列的“日落海滩”图片：

curl -s "https://api.search.brave.com/res/v1/images/search?q=sunset%20beach&count=5&country=IL" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

然后从JSON响应中提取：

• 缩略图：.results[0].thumbnail.src
• 完整图片：.results[0].properties.url

结果交付

当呈现图片搜索结果时：

1. 直接向用户发送图片（不要仅列出URL）
2. 使用results[].properties.url获取完整图片，或使用results[].thumbnail.src用于缩略图
3. 将图像标题作为图注包含
4. 如果存在比显示的更多的结果，告知用户（例如，"找到20张图片，显示3张——需要更多吗？"）

示例流程：

User: "find me pictures of sunsets"
→ Search with count=10
→ Send 3-5 images with captions
→ "Found 10 sunset images, showing 5. Want to see more?"

注意事项

• 对查询字符串进行URL编码（空格转换为%20）
• 来自环境变量的API密钥：$BRAVE_API_KEY
• 遵守订阅层级的速率限制