跳转到主要内容
PipeLLM 通过公共网关暴露 WebSearch。适合直接在应用、后端或 Agent 工作流里获取网络 搜索结果,而不需要安装 npm 插件。

Endpoint

方法端点
GEThttps://api.pipellm.ai/v1/websearch/search

认证

Authorization: Bearer $PIPELLM_API_KEY

查询参数

参数类型必填描述
qstring搜索关键词

这条路由会做什么

/v1/websearch/search 是完整检索链路。它会先拿搜索结果,再抽取页面内容,随后做向量 相似度检索和重排序,并在有内容可用时返回上下文。

请求示例

curl -X GET "https://api.pipellm.ai/v1/websearch/search?q=最新AI新闻" \
  -H "Authorization: Bearer $PIPELLM_API_KEY"

响应格式

{
  "code": 200,
  "message": "ok",
  "took_ms": 6050,
  "data": {
    "organic": [
      {
        "title": "AI News | Latest News | Insights Powering AI-Driven Business ...",
        "link": "https://www.artificialintelligence-news.com/",
        "snippet": "AI News delivers the latest updates in artificial intelligence..."
      },
      {
        "title": "The Latest AI News and AI Breakthroughs that Matter Most",
        "link": "https://www.crescendo.ai/news/latest-ai-news-and-updates",
        "snippet": "Summary: Xiaomi has announced a next-gen AI voice model...",
        "contexts": [
          {
            "idx": 0,
            "text": "December 26, 2025\n\n# The Latest AI News and AI Breakthroughs..."
          }
        ]
      }
    ]
  }
}

响应字段

字段类型描述
codeinteger200 表示成功
messagestring状态信息
took_msinteger请求耗时(毫秒)
data.organicarray自然搜索结果
data.organic[].titlestring页面标题
data.organic[].linkstring页面 URL
data.organic[].snippetstring搜索摘要
data.organic[].contextsarray可选的页面上下文内容
data.organic[].contexts[].idxinteger上下文索引
data.organic[].contexts[].textstring提取出的文本内容

错误返回

{
  "code": 400,
  "message": "Bad Request, missing query parameter"
}

价格与限制

项目
价格每次成功请求 $0.05
限流模型共享账号级限额
重试行为如果收到带 Retry-After503 Service Unavailable,请等待后重试

示例:给 LLM 注入 RAG 上下文

import os
import requests
from openai import OpenAI

search_response = requests.get(
    "https://api.pipellm.ai/v1/websearch/search",
    params={"q": "OpenAI o3 模型能力"},
    headers={"Authorization": f"Bearer {os.getenv('PIPELLM_API_KEY')}"},
)
search_data = search_response.json()

context = "\n".join(
    f"[{r['title']}]({r['link']}): {r['snippet']}"
    for r in search_data.get("data", {}).get("organic", [])[:5]
)

client = OpenAI(
    api_key=os.getenv("PIPELLM_API_KEY"),
    base_url="https://api.pipellm.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": f"请基于以下上下文回答:\n{context}"},
        {"role": "user", "content": "OpenAI o3 有哪些主要特性?"},
    ],
)

print(response.choices[0].message.content)

相关文档

WebSearch 总览

产品总览、价格和接入入口

快速搜索

更快的搜索路由,不做深度检索

pipellm-websearch(npm)

从 npm 安装 OpenClaw 插件