Brave 图像搜索 API 使用指南 - 快速集成图像搜索功能

images-search by brave/brave-search-skills

278 周安装量

95 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/brave/brave-search-skills --skill images-search

图像处理 API 搜索

🇨🇳中文介绍

图像搜索

需要 API 密钥 : 在 https://api.search.brave.com 获取

套餐 : 包含在搜索套餐中。参见 https://api-dashboard.search.brave.com/app/subscriptions/subscribe

快速开始 (cURL)

基础搜索

curl -s "https://api.search.brave.com/res/v1/images/search?q=mountain+landscape" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

带参数搜索

curl -s "https://api.search.brave.com/res/v1/images/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=northern lights photography" \
  --data-urlencode "country=US" \
  --data-urlencode "search_lang=en" \
  --data-urlencode "count=20" \
  --data-urlencode "safesearch=strict"

端点

GET https://api.search.brave.com/res/v1/images/search

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试

50,400 周安装

Lark Skill Maker 教程：基于飞书CLI创建AI技能，自动化工作流与API调用指南

39,100 周安装

Lark CLI Wiki API 使用指南：获取知识空间节点信息与权限管理

39,100 周安装

认证 : X-Subscription-Token: <API_KEY> 请求头

参数	类型	必需	默认值	描述
`q`	string	是	-	搜索查询 (1-400 字符，最多 50 个单词)
`country`	string	否	`US`	搜索国家 (2 字母国家代码或 `ALL`)
`search_lang`	string	否	`en`	2+ 字符语言代码
`count`	int	否	50	返回的结果数量 (1-200)
`safesearch`	string	否	`strict`	`off` 或 `strict` (图像搜索无 `moderate` 选项)
`spellcheck`	bool	否	true	自动纠正查询；纠正后的查询在 `query.altered` 中

{
  "type": "images",
  "query": {
    "original": "mountain landscape",
    "altered": null,
    "spellcheck_off": false,
    "show_strict_warning": false
  },
  "results": [
    {
      "type": "image_result",
      "title": "Beautiful Mountain Landscape",
      "url": "https://example.com/mountain-photo",
      "source": "example.com",
      "page_fetched": "2025-09-15T10:30:00Z",
      "thumbnail": {
        "src": "https://imgs.search.brave.com/...",
        "width": 200,
        "height": 150
      },
      "properties": {
        "url": "https://example.com/images/mountain.jpg",
        "placeholder": "https://imgs.search.brave.com/placeholder/...",
        "width": 1920,
        "height": 1080
      },
      "meta_url": {
        "scheme": "https",
        "netloc": "example.com",
        "hostname": "example.com",
        "favicon": "https://imgs.search.brave.com/favicon/...",
        "path": "/mountain-photo"
      },
      "confidence": "high"
    }
  ],
  "extra": {
    "might_be_offensive": false
  }
}

字段	类型	描述
`type`	string	始终为 `"images"`
`query.original`	string	原始查询
`query.altered`	string?	拼写检查后的查询 (若无修正则为 null)
`query.spellcheck_off`	bool?	是否禁用了拼写检查
`query.show_strict_warning`	bool?	如果严格安全搜索隐藏了相关结果则为 true
`results[]`	array	图像结果列表
`results[].type`	string	始终为 `"image_result"`
`results[].title`	string?	图像标题
`results[].url`	string?	找到图像的页面 URL
`results[].source`	string?	来源域名
`results[].page_fetched`	string?	上次页面抓取的 ISO 日期时间
`results[].thumbnail.src`	string?	Brave 代理的缩略图 URL (~500px 宽度)
`results[].thumbnail.width`	int?	缩略图宽度
`results[].thumbnail.height`	int?	缩略图高度
`results[].properties.url`	string?	原始全尺寸图像 URL
`results[].properties.placeholder`	string?	低分辨率占位图 URL (Brave 代理)
`results[].properties.width`	int?	原始图像宽度 (可能为 null)
`results[].properties.height`	int?	原始图像高度 (可能为 null)
`results[].meta_url.scheme`	string?	URL 协议方案
`results[].meta_url.netloc`	string?	网络位置
`results[].meta_url.hostname`	string?	小写域名
`results[].meta_url.favicon`	string?	网站图标 URL
`results[].meta_url.path`	string?	URL 路径
`results[].confidence`	string?	相关性：`low`、`medium` 或 `high`
`extra.might_be_offensive`	bool	结果是否可能包含冒犯性内容

视觉内容发现 : 构建图像库、情绪板或视觉研究工具。需要全面覆盖时使用 count=200。当需要图像特定元数据（尺寸、缩略图）时，优先选择此搜索而非 web-search。
内容增强 : 为文章或生成内容添加相关图像。使用 country 和 search_lang 来定位目标受众的区域设置。
安全图像检索 : 默认 safesearch=strict 确保开箱即用的家庭友好型结果。只有两种模式 (off/strict) —— 与网页/视频/新闻搜索不同，没有 moderate 选项。
高批量检索 : 每个请求最多可获取 200 张图像 (网页搜索为 20，视频/新闻为 50)。非常适合批量图像来源或视觉分析流水线。

安全搜索 : 图像搜索默认为 strict (比网页搜索更严格)
高容量 : 每个请求最多可返回 200 个结果
缩略图 : 为保护用户隐私，由 Brave 代理 (宽度约 500px)。使用 properties.url 获取原始全分辨率图像。
尺寸 : 部分图像的 properties.width/height 可能缺失
占位图 : properties.placeholder 是一个低分辨率 URL (非内联 base64)，可用于渐进式加载的用户体验

2026 年 2 月 13 日

🇺🇸English

Images Search

Requires API Key : Get one at https://api.search.brave.com

Plan : Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Quick Start (cURL)

Basic Search

curl -s "https://api.search.brave.com/res/v1/images/search?q=mountain+landscape" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

With Parameters

curl -s "https://api.search.brave.com/res/v1/images/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=northern lights photography" \
  --data-urlencode "country=US" \
  --data-urlencode "search_lang=en" \
  --data-urlencode "count=20" \
  --data-urlencode "safesearch=strict"

Endpoint

GET https://api.search.brave.com/res/v1/images/search

Authentication : X-Subscription-Token: <API_KEY> header

Parameters

Parameter	Type	Required	Default	Description
`q`	string	Yes	-	Search query (1-400 chars, max 50 words)
`country`	string	No	`US`	Search country (2-letter country code or `ALL`)
`search_lang`	string	No

Response Format

{
  "type": "images",
  "query": {
    "original": "mountain landscape",
    "altered": null,
    "spellcheck_off": false,
    "show_strict_warning": false
  },
  "results": [
    {
      "type": "image_result",
      "title": "Beautiful Mountain Landscape",
      "url": "https://example.com/mountain-photo",
      "source": "example.com",
      "page_fetched": "2025-09-15T10:30:00Z",
      "thumbnail": {
        "src": "https://imgs.search.brave.com/...",
        "width": 200,
        "height": 150
      },
      "properties": {
        "url": "https://example.com/images/mountain.jpg",
        "placeholder": "https://imgs.search.brave.com/placeholder/...",
        "width": 1920,
        "height": 1080
      },
      "meta_url": {
        "scheme": "https",
        "netloc": "example.com",
        "hostname": "example.com",
        "favicon": "https://imgs.search.brave.com/favicon/...",
        "path": "/mountain-photo"
      },
      "confidence": "high"
    }
  ],
  "extra": {
    "might_be_offensive": false
  }
}

Response Fields

Field	Type	Description
`type`	string	Always `"images"`
`query.original`	string	Original query
`query.altered`	string?	Spellchecked query (null if no correction)
`query.spellcheck_off`	bool?	Whether spellcheck was disabled
`query.show_strict_warning`

Use Cases

Visual content discovery : Build image galleries, mood boards, or visual research tools. Use count=200 for comprehensive coverage. Prefer over web-search when you need image-specific metadata (dimensions, thumbnails).
Content enrichment : Add relevant images to articles or generated content. Use country and search_lang to target your audience's locale.
Safe image retrieval : Default safesearch=strict ensures family-friendly results out of the box. Only two modes (off/strict) — no moderate option, unlike web/video/news search.
High-volume batch retrieval : Up to 200 images per request (vs 20 for web, 50 for videos/news). Ideal for bulk image sourcing or visual analysis pipelines.

Notes

SafeSearch : Defaults to strict for images (stricter than web search)
High volume : Can return up to 200 results per request
Thumbnails : Brave-proxied for user privacy (500px width). Use properties.url for original full-resolution image.
Dimensions : properties.width/height may be missing for some images
Placeholder : properties.placeholder is a low-res URL (not inline base64) useful for progressive loading UX

Weekly Installs

Repository

brave/brave-sea…h-skills

GitHub Stars

First Seen

Feb 13, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

gemini-cli54

codex54

github-copilot53

kimi-cli53

opencode53

amp52

lark-cli 共享规则：飞书资源操作指南与权限配置详解

39,000 周安装