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

快速入门

最近更新时间：2026-01-05 14:47:51

我的收藏

本页目录：

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

准备工作

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

操作步骤

步骤一：开通服务

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


步骤二：获取云 API 密钥

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

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


步骤三：接入 API

请根据接入指南，参考 API 文档 示例调用对应的接口，即可开始使用。

通过 API 3.0 Explorer 在线调用

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

登录 腾讯云 API Explorer，搜索 联网图像搜索 (WIMGS)，选择需要调用的 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.wimgs.v20251106 import wimgs_client, models
try:
    # 密钥信息从环境变量读取，需要提前在环境变量中设置 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY
    # 使用环境变量方式可以避免密钥硬编码在代码中，提高安全性
    # 生产环境建议使用更安全的密钥管理方案，如密钥管理系统(KMS)、容器密钥注入等
    # 请参见：https://cloud.tencent.com/document/product/1278/85305
    # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
    cred = credential.Credential(os.getenv("TENCENTCLOUD_SECRET_ID"), os.getenv("TENCENTCLOUD_SECRET_KEY"))
    # 使用临时密钥示例
    # cred = credential.Credential("SecretId", "SecretKey", "Token")
    # 实例化一个http选项，可选的，没有特殊需求可以跳过
    httpProfile = HttpProfile()
    httpProfile.endpoint = "wimgs.tencentcloudapi.woa.com"

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

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

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

except TencentCloudSDKException as err:
    print(err)

中国站
目录