跳到主要内容

Cloudsway（搜索，中国区）

中国区的另一条搜索通道，适合你先拿网页结果，再自行做摘要、RAG、重排或喂给其他模型。

  • 端点：GET /proxy/cloudsway/search
  • 必填参数：q
  • 常用参数：count、freshness、offset、enableContent、contentType、contentTimeout、mainText、sites、blockWebsites
  • 请求头：通常只需要 Authorization；Pragma、Accept 等头可按调用方需要自行决定是否传入
curl --location "$TURING_BASE_URL/proxy/cloudsway/search?q=%E6%97%A5%E6%9C%AC" \
  -H "Authorization: Bearer $TURING_API_KEY" \
  -H "Accept: */*"

参数说明：

  • q：搜索查询词，不能为空。
  • count：返回结果数量，默认 10，最大 50，可选值范围 1-50。
  • freshness：按时间过滤结果，可选 Day / Week / Month。
  • offset：分页偏移量，默认 0；设置过大时可能返回空结果。
  • enableContent：是否抓取网页长摘要；true 返回长摘要，false 不返回，默认 false。
  • contentType：长摘要格式，仅在 enableContent=true 时生效，可选 HTML / MARKDOWN / TEXT，默认返回 TEXT。
  • contentTimeout：长摘要读取超时，单位秒，默认 0，最大 10，仅在 enableContent=true 时生效。
  • mainText：是否返回与查询最相关的正文片段，仅在 enableContent=true 时生效。
  • sites：只保留指定站点结果，值需填写 host，例如 baijiahao.baidu.com。
  • blockWebsites：过滤指定站点结果，值需填写 host，例如 baijiahao.baidu.com。

响应字段与 Legacy Bing Proxy 基本一致，常见字段包括：

  • queryContext.originalQuery：原始查询词。
  • webPages.value[]：搜索结果数组。
  • webPages.value[].name / url / snippet：标题、链接、短摘要。
  • webPages.value[].datePublished：页面发布时间，部分结果包含。
  • webPages.value[].mainText：与查询最相关的正文片段。
  • webPages.value[].siteName：站点名称，部分结果包含。
  • webPages.value[].contentCrawled：长摘要是否抓取成功。
  • webPages.value[].content：网页长摘要正文。
  • webPages.value[].logo / imageList / score：站点图标、图片列表、内容相关性分数。
提示

如果你只需要标准搜索结果，通常只传 q 和 count 即可；只有在要做摘要增强或构造 RAG 上下文时，再打开 enableContent / mainText。

备注

sites 和 blockWebsites 都要求填写 host，不要带协议头，例如填写 www.tiktok.com，不要写成 https://www.tiktok.com。