文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>联网搜索API>快速入门

快速入门

最近更新时间：2025-10-24 15:15:21

我的收藏

本页目录：

本文为您介绍初次使用联网搜索服务需要实施的准备工作及入门操作。
操作步骤
说明
步骤一：登录注册
注册腾讯云账号，完成实名认证并登录
步骤二：开通服务
控制台自助开通联网搜索API 权限
步骤三：获取云 API 密钥
获取云 API 密钥的 SecretId 和 SecretKey
步骤四：接入 API
根据 API 文档接入联网搜索服务

步骤一：登录注册

注册并通过个人实名认证或企业认证后，登录 腾讯云。如果没有账号，请参考 注册腾讯云。

步骤二：开通服务

进入联网搜索API 控制台 概览页面，单击开通服务，按照 购买方式 文档指引按需完成服务开通和购买。


步骤三：获取云 API 密钥

1. 前往腾讯云官网控制台 API 密钥管理 界面获取密钥。

2. 单击新建密钥，弹窗获取 SecretId 和 SecretKey，可单击下载 CSV 文件保存至本地。
注意：
为降低密钥泄漏的风险，自2023年11月30日起，新建的密钥只在创建时提供 SecretKey，后续不可再进行查询，请保存好 SecretKey。


步骤四：接入 API

请根据接入指南，参考 联网搜索接口 示例调用对应的接口，即可开始使用。

通过 API 3.0 Explorer 在线调用

适用对象：开发初学者，有代码编写基础人员。
说明：此方式能够实现在线调用、签名验证、SDK 代码生成和快速检索接口等能力。

在 API 概览 选择需要调用的接口，选择点击调试进入调试页面。并填写输入参数。输入参数在 API 3.0 Explorer 界面的“文档说明”选项卡中可以查看对应接口输入参数的具体含义。
说明：
平台将对登录用户提供临时 Access Key，以便进行调试。


通过编写代码，调用 API 进行开发

适用对象：开发工程师，熟悉代码编写人员。
说明：腾讯云已编写好的开发工具集（SDK），支持通过调用同传服务 API 开发功能。目前 SDK 已支持多种语言，包括 Python、Java、PHP、Go、Node.js、.Net 等，可在每个服务的文档中下载对应的 SDK。

进入 API Explorer 页面，选择需要调用的接口，在右侧选项卡中选择“代码示例”，选择接入方式和开发语言，并填写参数，即可得到示例代码。

下面以 Python 代码为例，说明 API 本地调用的方法。
1. 安装 腾讯云 SDK 对应版本代码。
pip install tencentcloud-sdk-python

2. 按如下示例代码调用接口：
仅需修改如下示例代码中：TENCENTCLOUD_SECRET_ID,TENCENTCLOUD_SECRET_KEY 密钥信息，以及对应的接口入参。
# -*- coding: utf-8 -*-

import os
import json
import types
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.wsa.v20250508 import wsa_client, models
try:
    # 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密
    # 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性
    # 以下代码示例仅供参考，建议采用更安全的方式来使用密钥
    # 请参见：https://cloud.tencent.com/document/product/1278/85305
    # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
    cred = credential.Credential("TENCENTCLOUD_SECRET_ID","TENCENTCLOUD_SECRET_KEY")
    # 使用临时密钥示例
    # cred = credential.Credential("SecretId", "SecretKey", "Token")
    # 实例化一个http选项，可选的，没有特殊需求可以跳过
    httpProfile = HttpProfile()
    httpProfile.endpoint = "wsa.tencentcloudapi.com"

    # 实例化一个client选项，可选的，没有特殊需求可以跳过
    clientProfile = ClientProfile()
    clientProfile.httpProfile = httpProfile
    # 实例化要请求产品的client对象,clientProfile是可选的
    client = wsa_client.WsaClient(cred, "", clientProfile)

    # 实例化一个请求对象,每个接口都会对应一个request对象
    req = models.SearchProRequest()
    params = {
        "Query": "北京天气"
    }
    req.from_json_string(json.dumps(params))

    # 返回的resp是一个SearchProResponse的实例，与请求对象对应
    resp = client.SearchPro(req)
    # 输出json格式的字符串回包
    print(resp.to_json_string())

except TencentCloudSDKException as err:
    print(err)


中国站
目录