Brave Images

核心用法

Brave Image Search 是一个通过Brave Search API实现的专业图片检索工具，适用于需要获取各类视觉内容的场景。该工具通过简单的HTTP GET请求即可返回结构化的图片搜索结果。

基础调用方式：

curl -s "https://api.search.brave.com/res/v1/images/search?q=QUERY&count=COUNT" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

主要参数包括搜索词（必需）、结果数量（1-100，默认20）、国家代码、语言代码和安全搜索级别。响应结果包含图片标题、完整URL、缩略图、来源网站及尺寸信息。

显著优点

1. 隐私优先：Brave作为以隐私保护著称的搜索引擎，其API继承了不追踪用户、无个性化广告过滤的特性
2. 简洁高效：API设计直观，返回JSON格式易于解析，适合自动化工作流集成
3. 全球覆盖：支持多语言和地区偏置设置，可获取本地化内容
4. 灵活的安全控制：三级安全搜索（关闭/适中/严格）适应不同场景需求

潜在缺点与局限性

1. 付费门槛：需要有效的Brave Search API订阅密钥（BRAVE_API_KEY），免费额度有限
2. 结果不可控：图片质量、版权状态、可用性取决于原始来源，无内置版权过滤
3. 无高级筛选：缺乏按尺寸、颜色、类型（照片/插图）、时间等维度的细粒度过滤
4. 依赖外部服务：API可用性和响应速度受Brave服务器状态影响

适合人群

• 开发者构建需要图片检索功能的应用或自动化脚本
• 内容创作者快速获取参考图片或配图素材
• 研究人员进行视觉内容的数据收集和分析
• 需要隐私友好型搜索方案的企业用户

常规风险

• 版权问题：返回的图片可能受版权保护，商业使用需自行核实授权
• 内容安全：尽管有安全搜索选项，仍可能返回不适宜内容（建议启用strict模式处理敏感场景）
• API密钥泄露：BRAVE_API_KEY需妥善保管，避免硬编码在公开代码库中
• 速率限制：超出订阅 tier 的调用频率可能导致服务中断或额外费用

核心用法

brave-images 是一个纯文档型 API 封装 Skill，用于调用 Brave Search API 进行图片搜索。使用时需配置 BRAVE_API_KEY 环境变量，通过构造 HTTPS GET 请求至 api.search.brave.com/res/v1/images/search，支持关键词查询、结果数量控制（1-100）、国家/地区偏好（如 US、DE、IL）、语言过滤及三级安全搜索模式（off/moderate/strict）。

典型调用流程：
1. URL 编码搜索词
2. 携带 X-Subscription-Token 头部发送请求
3. 解析 JSON 响应，提取 results[].properties.url（原图）或 results[].thumbnail.src（缩略图）
4. 直接向用户展示图片并附带标题说明

显著优点

• 隐私优先：Brave 以隐私保护著称，API 不追踪用户搜索行为
• 无代码负担：纯 Markdown 文档，零依赖、零运行时风险
• 灵活可控：支持区域定向、语言过滤、安全等级调节
• 响应完整：返回图片元数据（尺寸、来源网站），便于二次处理
• 商业可用：Brave Search API 提供稳定的企业级服务

潜在局限

• 依赖外部服务：需自行注册 Brave Search API 并管理配额
• 无内置错误处理：示例代码未展示 401/429/500 等异常处理逻辑
• 来源不可验证：Skill 本身为内部发布（T3），无公开 GitHub 仓库
• 功能单一：仅支持搜索，无图片编辑、上传等扩展能力

适合人群

• 需要快速集成图片搜索的开发者
• 注重用户隐私的 AI 应用构建者
• 已有 Brave API 订阅的团队

常规风险

• API Key 泄露：需妥善保管环境变量，避免硬编码
• 配额耗尽：高频调用可能触发速率限制
• 内容合规：依赖 Brave 的安全搜索过滤，但仍需人工审核敏感场景