联网搜索

服务列表

• 获取身份鉴权信息

  通过API调用AI搜索开放平台服务时，需要对调用者身份进行鉴权，如何获取鉴权信息请参见获取API-KEY。

• 获取服务调用地址

  支持通过公网和VPC两种方式调用服务，详情请参见获取服务接入地址。

请求方式

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/web-search/{service_id}

• host：调用服务的地址，支持通过公网和VPC两种方式调用API服务，可参见获取服务接入地址。

  在API Keys页面顶部选择目标工作空间（如default(默认空间)），在访问域名区域切换公网API域名或私网API域名标签查看对应的服务接入地址。

• workspace_name：工作空间名称，例如default。

• service_id： 系统内置服务ID，例如ops-web-search-001。

请求参数

Header参数

API-KEY认证

Body参数

Curl请求示例

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 您的API-KEY" \
"http://xxxx-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/web-search/ops-web-search-001" \
-d '{
      "history": [
        {"role": "system", "content": "你是一个机器人助手"},
        {"role": "user", "content": "浙江的省会是哪里"},
        {"role": "assistant", "content": "杭州"}
        ],
      "query":"杭州今日天气怎么样",
      "query_rewrite":true,
      "top_k":5,
      "content_type":"snippet"
}'

指定搜索与正文提取策略

通过way指定更高效果的搜索与正文提取策略，配合content_type取值mainText获取网页正文。

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 您的API-KEY" \
"http://xxxx-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/web-search/ops-web-search-001" \
-d '{
      "query":"杭州今日天气怎么样",
      "top_k":5,
      "content_type":"mainText",
      "way":"pro-fetch"
}'

返回参数

响应示例

正常响应示例

{
  "request_id": "5B9F5A24-8F1D-****-B7E2-3C6A1D9E4F02",
  "latency": 2.3,
  "usage": {
    "ops-web-search-001/pro-fetch": 1,
    "ops-web-search-001/pro": 1
  },
  "result": {
    "search_result": [
      {
        "title": "杭州气象微博",
        "link": "https://www.hzqx.cn/pc/hztq/",
        "snippet": "较昨日同期 持平 相对湿度：-%风力：-气压：-hPa 近1小时降水:-mm 能见度：-m 实时数据、未经人工复核 2026年08月26日 10时55分 ...2026-08-26 08:00 更新 空气质量预报 杭州市环境监测站和杭州市气 ...",
        "position": null,
        "meta_info": {
          "publishedTime": "2026-08-26T10:55:00+08:00"
        },
        "content": "杭州气象微博\n较昨日同期 持平\n相对湿度： -- % 风力： --\n气压： -- hPa 近1小时降水: -- mm\n能见度： -- m\n\n# \\*实时数据、未经人工复核\n\n2026年08月26日 10时55分 过去24小时 未来24小时 未来7天\n\n# 主城区 未来7天天气客观预报 （该预报数据为\n...（此处省略，实际返回为完整网页正文）"
      },
      {
        "title": "杭州7天天气",
        "link": "https://www.ip.cn/tianqi/zhejiang/hangzhou/7day.html",
        "snippet": "杭州天气：2026-08-20至2026-08-26 天气预报 一 二 三 四 五 六 日 08月20日 中雨转多云 25℃～31℃ 日出05:29 日落18:36 08月21日 小雨转阴 25℃～32℃ 日出05:29 日落18:35 0 ...",
        "position": null,
        "meta_info": {
          "publishedTime": "2026-08-21T00:00:00+08:00"
        },
        "content": "杭州7天天气\n27° 多云 20 优\n东风 <3级 湿度 96% 气压 1001 Pa\n最新浙江省杭州市7天天气，包含每天最高气温、最低气温、天气状况及风向等天气信息\n今天 7天 10天 15天 最近30天\n杭州天气：2026-08-20至2026-08-26 天气预报\n\n| 一 | 二 | 三 |\n...（此处省略，实际返回为完整网页正文）"
      }
    ]
  }
}

异常响应示例

在访问请求出错的情况下，输出的结果中会通过code和message指明出错原因。

{
    "request_id": "6F33AFB6-A35C-****-AFD2-9EA16CCF4383",
    "latency": 2.0,
    "code": "InvalidParameter",
    "http_code": 400,
    "message": "JSON parse error: Cannot deserialize value of type `ImageStorage` from String \\"xxx\\"
}

状态码说明

详情请参见AI搜索开放平台状态码说明。