需完成五步操作:一、注册实名腾讯云账号;二、进入腾讯元器控制台开通服务;三、创建智能体获取assistant_id与token;四、申请SecretId与SecretKey;五、配置安全组与访问白名单。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望调用腾讯元宝API接口,但尚未获得合法访问凭证,则需完成身份认证与密钥申领流程。以下是具体操作步骤:
一、注册实名腾讯云账号
腾讯元宝API由腾讯云平台统一管理,必须通过已完成实名认证的腾讯云账号进行申请。未注册用户需先完成企业或个人身份注册,并通过手机与邮箱双重验证。
1、访问腾讯云官网(https://cloud.tencent.com/)并点击右上角“注册”按钮。
2、选择“个人用户”或“企业用户”,按提示填写真实姓名、身份证号(企业需提供营业执照信息)及联系方式。
3、完成短信验证码与邮箱验证后,设置登录密码并完成实名认证绑定。
二、进入腾讯元器控制台开通服务
腾讯元宝API实际依托于“腾讯元器”智能体平台提供,需在该平台中启用对应能力并创建可用资源实例。
1、登录腾讯云后,在控制台顶部搜索栏输入“元器”,进入“腾讯元器”产品页。
2、点击“立即使用”,系统将自动跳转至元器控制台首页。
3、首次访问时需同意《服务协议》与《隐私政策》,并完成基础环境初始化。
三、创建智能体并获取assistant_id与token
每个可对外提供服务的API调用均需绑定一个已发布的智能体,其ID与Token共同构成有效身份标识。
1、在元器控制台点击“创建智能体”,填写名称(如“客服助手”)、简介及角色设定。
2、配置知识库(支持上传PDF/DOCX/TXT或授权公众号文章),完成后点击“保存并发布”。
3、发布成功后,在智能体详情页点击“使用方式”,在“API接入”区域查看assistant_id与token字段值。
四、申请SecretId与SecretKey
部分高级调用场景(如直连大模型生成接口)需额外申请腾讯云通用API密钥,用于请求签名认证。
1、返回腾讯云控制台,进入“访问管理 > API密钥管理”页面。
2、点击“新建密钥”,选择“程序化调用”类型,并勾选“仅用于API调用”权限策略。
3、系统生成SecretId与SecretKey,弹窗提示“请立即下载保存”,SecretKey仅显示一次且不可恢复。
五、配置安全组与访问白名单
为防止未授权调用,腾讯云默认限制API端点的公网访问权限,需手动放行目标IP或启用Token鉴权模式。
1、在云服务器或API网关控制台中,定位到对应实例的安全组规则配置页。
2、添加入站规则,协议类型选择TCP,端口范围填入API服务所用端口(如443),源IP地址填入您的服务器公网IP或指定IP段。
3、若采用Token鉴权方式,需在调用请求头中携带Authorization: Bearer {token},并在元器控制台智能体设置中开启“Token校验”开关。


















