/v1/searchSearch
计费搜索费用取决于所选后端与计费单位。 价格与线路 ↗
通过 Lazu 统一调用 Web 或 News 搜索。托管版 api.lazu.ai 当前启用了 Tavily、Serper 和 Jina；自部署管理员也可以通过同一套 Search Backend 系统接入 Exa 或 Brave。
返回什么
归一化结果
不同 provider 都会映射成 title、url、
snippet、可选的 content、published_at
、score 和 source。
可解释路由
响应会返回实际选中的 backend 和 route receipt。请求日志中也会保存同样的 routing 元数据，便于排障和对账。
托管版配置
/v1/search 的实现支持 Tavily、Serper、Exa、Jina 和 Brave，但请查看当前展示的搜索价格，并在请求详情核对 web_search 计费明细；不要根据旧示例或部署配置推断搜索免费。
| Backend | 托管版状态 | 能力 | 说明 |
|---|---|---|---|
| Tavily | 已启用 | web_search、web_fetch、answer | 支持 include_answer 和 search_depth；advanced 按 2 units 计算。 |
| Serper | 已启用 | web_search | 会映射 country / region、language 和 time_range。 |
| Jina | 已启用 | web_search、web_fetch | 使用 https://s.jina.ai，更适合 retrieval 风格的 snippet。 |
| Exa / Brave | 代码支持 | 管理员配置后支持 web_search | 适用于自部署或管理员后续配置的托管环境。 |
当前托管版 backend 使用默认策略：每次请求最多返回 10 条结果，上游 timeout 为 8s。
如果请求里的 max_results 更大，Lazu 会按选中的 backend policy 截断。
请求 Body
query搜索 query。当前 MVP 每次请求支持一个 query。
typewebnews搜索类型，默认 web。
backendauto、provider 名称如 tavily /serper
，或已配置的 backend ID/name。默认 auto。
region地区 hint。Serper 会映射到 gl。
language语言 hint，例如 en 或 zh-CN。
time_rangedayweekmonthyear时间范围 hint。provider 不支持时可能忽略。
max_results返回结果数。默认 10，并受 backend policy 上限约束。
search_depthbasicadvancedprovider 深度 hint。Tavily advanced 会消耗 2 个计费 unit。
include_answerselected backend 返回 answer 时一并返回。Lazu 不在这个 endpoint 内生成最终答案。
include_raw_contentprovider 返回原文或清洗正文时是否透出，默认 false。
include_domains限制搜索域名。token 级 domain allowlist 仍会生效。
exclude_domains排除域名，取决于 selected backend 是否支持。
include_provider_payload返回 provider 原始 payload，主要用于排障。默认 false。
provider_options高级 provider passthrough。只会使用当前 provider 对应对象，例如
{"serper":{"tbs":"qdr:d"}}。
响应
{
"query": "latest OpenAI web search API changes",
"results": [
{
"title": "Web search - OpenAI API",
"url": "https://platform.openai.com/docs/guides/tools-web-search",
"snippet": "Use web search in the Responses API...",
"content": null,
"published_at": null,
"score": 0.91,
"source": "web"
}
],
"usage": {
"web_search_requests": 1,
"web_search_billable_units": 1
},
"provider_trace": {
"backend": "tavily"
},
"route_receipt": {
"selection": "auto",
"selected_backend": "tavily",
"chose_provider": "tavily",
"candidates": ["tavily:Tavily"],
"rejected": [],
"downgraded": false,
"fallback_count": 0,
"decision_reason": "selected"
}
}results[]归一化搜索结果。只有请求了 raw content 且 backend 返回时，
content 才会填充。
usage.web_search_requestsLazu 搜索请求次数，通常为 1。
usage.web_search_billable_units实际计费用的 provider unit。Tavily basic 为 1，Tavily advanced 为 2， Serper 和 Jina 通常为 1 个成功 query。
provider_trace.backend路由后实际选中的 provider。
route_receipt候选、fallback、拒绝原因等路由元数据，同步写入请求日志。
计费
Search backend 的价格来自配置里的 search_price。这个值表示每个
provider billing unit 的 USD 价格，不一定等同于每个 HTTP request 的价格。
当前托管版 Tavily、Serper 和 Jina 没有显式配置 search_price，
所以 Lazu 会记录 web_search usage，但 search line item 费用为
$0；后续管理员配置价格或 provider-cost passthrough 后才会按配置收费。
| Backend | Unit 映射 |
|---|---|
| Tavily | basic = 1 credit；advanced = 2 credits |
| Serper | 1 个成功 query = 1 unit |
| Jina | 1 个成功 query = 1 unit |
上游失败、timeout、参数错误会按 Lazu 常规计费规则 refund。
相关页面
curl https://api.lazu.ai/v1/search \-H "Authorization: Bearer $LAZU_API_KEY" \-H "Content-Type: application/json" \-d '{"query": "latest OpenAI web search API changes","type": "web","max_results": 5,"backend": "auto"}'
独立示例，并非当前报价或上方请求的执行结果。实际费用以完成请求的回执为准。
- Request ID
- req_demo_01
- 搜索后端
- example-search-backend
- 线路
- stable
- 搜索计费单位
- 1
- 耗时
- 842 ms
- Key
- demo-key
Try it · real request›
No key yet? Console → API Keys → Create key
{"query": "latest OpenAI web search API changes","results": [{"title": "OpenAI ships web search API","url": "https://example.com/news","snippet": "…","score": 0.92,"source": "tavily"}],"usage": {"web_search_requests": 1,"web_search_billable_units": 1},"provider_trace": { "backend": "tavily" },"route_receipt": {"selection": "auto","selected_backend": "search_tavily","chose_provider": "tavily","candidates": ["search_tavily"],"decision_reason": "matched web_search capability"}}
{"error": {"type": "rate_limit_exceeded","message": "Per-key limit reached. Retry after 12s.","request_id": "req_01ABCDEF"}}
控制台
管理员在 检索后端配置 provider。Calls api.lazu.ai directly. The key stays in this browser.