帮你快速理解、总结文档立即下载

创建接入点

最近更新时间:2026-11-16 14:35:30
我的收藏

操作场景

本文介绍如何在 ContextTurbo 控制台创建接入点。接入点是调用方与 ContextTurbo 的连接入口,每个接入点拥有独立的访问地址和 API Key。
创建页面按基本信息 → 模型接入 → 上下文压缩三块展开:填写地域与名称 → 选择模型来源并配置模型信息 → 按需配置网络信息 → 确认压缩开关 → 提交创建。

前提条件

已具备 ContextTurbo 控制台 访问权限。
模型来源选择已有模型且服务商选择其他时,已准备好模型 Base URL 和模型 API Key。
接入点支持广州、上海、北京、新加坡地域,默认广州。选择已有模型时,网络资源需与接入点同地域。
选择已有模型时,已按模型 API 的部署位置准备好网络资源:公网接入无需准备;VPC 私网需已创建同地域 VPC 和子网,且模型服务部署在该 VPC 内;专线接入需已开通至腾讯云的专线并创建关联 VPC 的专线网关;VPN 接入需已创建关联 VPC 的 IPsec VPN 网关并完成通道与双向路由配置。具体资源要求见步骤三。

三种模型来源对比

创建页的模型来源提供三个选项,分别对应不同的模型服务托管方式。
对比项
免费体验
新建模型
已有模型
模型从哪来
平台提供的免费额度
开通腾讯云大模型服务,使用账号下资源
接入已开通的模型服务
需填写的字段
无,页面展示可用额度
选择模型(可多选)
服务商、接入方式、模型 Base URL、模型 API Key,以及所属网络
适用场景
快速体验压缩效果,无需准备模型凭证
已有腾讯云大模型服务,希望按模型定价计费
使用自建或其他云上的模型服务,需要指定地址与网络
说明:
免费体验使用的免费额度需联系商务申请,申请通过后即可使用。

操作步骤

步骤一:进入创建页面并填写基本信息

2. 在左侧导航中选择接入点管理。
3. 选择目标地域。
4. 单击创建接入点,进入创建页面。

基本信息区域包含两项设置:
地域:选择接入点所在地域,支持广州、上海、北京、新加坡,默认广州。地域决定接入点和网络资源所在区域,创建后不可修改。
接入点名称:填写便于识别业务用途的名称,占位提示为 coding-production。

步骤二:配置模型接入

在模型接入区域先选择模型来源,再按所选来源填写模型信息。三种来源的区别见上一节,下面按来源分别说明。
免费体验
新建模型
已有模型

使用平台提供的免费额度,无需填写模型地址或凭证。免费额度需联系商务申请,通过后即可使用。页面展示模型免费额度的可用量与总量(例如 可用额度 4.9999 亿 / 总额度 5 亿 Token),可单击查看模型列表确认支持的模型。

开通腾讯云大模型服务并使用账号下资源,需完成三项:
配置项
说明
服务授权
展示当前账号的授权状态。未授权时需先完成授权,页面提示已授权后可继续。
选择模型
从下拉列表中选择模型,支持多选,至少选择一个。同一模型可能有多个版本,可参考名称后的调用参数区分。后续增减可用模型需修改接入点配置。
模型定价
提供查看模型定价入口。模型使用客户账号下的资源,按所选模型定价计费,不使用免费体验的模型额度。

接入已开通的模型服务。服务商提供两个选项,两者可填写的字段不同。
服务商选择腾讯云 TokenHub:完成服务授权后,在自定义推理服务下拉中选择已授权的服务。页面支持按服务名称、服务 ID 或接入模型搜索,停用的服务不可选;当前地域下无可用授权服务时,页面提供刷新入口与 TokenHub 管理跳转。

服务商选择其他:需填写接入方式、模型 Base URL、模型 API Key,并在页面下方选择所属网络。
配置项
说明
接入方式
API 接入:在接入点中保存模型 Base URL 与模型 API Key,由接入点统一发起调用。 透传模式:不在接入点保存地址与凭证,调用时由请求 Header 传入,且不能配置所属网络。若模型 API 仅能通过私网访问,需选择 API 接入并配置所属网络。
模型 Base URL
仅 API 接入需要填写。选择公网时填写 HTTP 或 HTTPS 地址;选择腾讯云 VPC 私网、专线、VPN 时填写模型服务的私网 IPv4、端口及 API 路径。
模型 API Key
仅 API 接入需要填写。用于访问模型服务,与接入点 Key 分开管理,保存后不展示明文。
选择已有模型时,页面下方还会展示网络信息区域,需继续完成步骤三。选择透传模式时不展示网络信息。

步骤三:配置网络信息

仅当模型来源选择已有模型、服务商选择其他且接入方式选择 API 接入时,页面才展示网络信息区域。先选择所属网络,再按所选类型填写网络资源。
所属网络
适用场景
需选择的资源
公网
模型 API 可通过公网访问。
无。
腾讯云 VPC 私网
模型服务部署在腾讯云 VPC 内。
所属 VPC(必选)、子网(可选)。
专线接入
模型部署在自有数据中心或其他云,已有至腾讯云的专线。
专线网关(必选)、所属 VPC(只读)、子网(必选)。
VPN 接入
已建立可用的 IPsec VPN 连接。
VPN 网关(必选)、所属 VPC(只读)、子网(必选)。
公网
腾讯云 VPC 私网
专线接入
VPN 接入
无需选择网络资源。模型 Base URL 填写可公网访问的地址,例如 https://api.example.com/v1。

1. 在所属 VPC 中,选择与接入点同地域、当前账号有权限访问的 VPC。字段说明为选择可访问模型 API 的腾讯云 VPC。
2. 在子网中,选择该 VPC 下的子网,可选,可选择多个。未选择 VPC 时该字段不可选。
3. 更换 VPC 后已选子网会被清空,需按新 VPC 重新选择。
模型 Base URL 填写该 VPC 内可达的模型 API 地址,例如模型服务通过 CLB 或 CVM 部署在 VPC 内时,填写其私网地址与端口。

1. 在专线网关中,选择与接入点同地域、已关联 VPC 的已有专线网关。当前地域下暂无已关联 VPC 的专线网关时,页面提示当前地域下暂无已关联私有网络 VPC 的专线网关,请先在对应控制台创建,并提供刷新入口。
2. 选定专线网关后,系统自动关联该网关的 VPC,所属 VPC 为只读。如需使用其他 VPC,请改选关联到目标 VPC 的专线网关。
3. 在子网中,从关联 VPC 中选择一个或多个子网,必选。
4. 更换专线网关后会重新关联 VPC,并清空已选子网。
模型 Base URL 填写可经专线访问的模型 API 地址。例如模型服务部署在其他云且已有至腾讯云的专线时,填写模型侧 API 的可达地址,并在专线接入中选择腾讯云侧的专线网关及其关联 VPC 的子网。
注意:
仅支持已关联 VPC 的专线网关,云联网类型的专线网关暂不支持。ContextTurbo 不提供专线开通能力,专线、路由与回程需提前具备访问条件。

1. 在 VPN 网关中,选择与接入点同地域、已关联 VPC 的已有 VPN 网关。当前地域下暂无已关联 VPC 的 VPN 网关时,页面提示当前地域下暂无已关联私有网络 VPC 的 VPN 网关,请先在对应控制台创建,并提供刷新入口。
2. 选定 VPN 网关后,系统自动关联该网关所属的 VPC,所属 VPC 为只读。
3. 在子网中,从关联 VPC 中选择一个或多个子网,必选。
4. 更换 VPN 网关后会重新关联 VPC,并清空已选子网。
模型 Base URL 填写 VPN 网络内可达的模型 API 地址。网关可用不代表模型 API 已可访问,VPN 通道及双向路由需提前配置完成。
注意:
更换接入点地域会清空已选网络资源;切换所属网络时,会清理原网络类型的专属配置。
ContextTurbo 不创建 VPN 网关,也不配置通道密钥;删除接入点或切换网络时,仅清理 ContextTurbo 自建连接,已有的 VPC、子网、专线网关、专线、VPN 网关和 VPN 通道均保留。

验证连通性

网络信息配置完成后,可在网络配置项下方单击验证连通性,无需先创建接入点。页面说明为填写模型和网络信息后,可验证模型 API 是否可访问及凭证是否有效。验证使用当前表单中的模型 Base URL、模型 API Key、地域及网络资源发起检查。
验证状态
页面反馈与操作
信息不完整
提示补齐模型地址、模型 API Key 或对应网络必填项,已填内容保留。
正在验证
按钮显示"正在验证"并进入加载状态,防止重复发起。
验证通过
提示"验证通过,模型 API 可访问且鉴权成功",并提供重新验证。
验证失败或超时
展示原因与处理方向,保留全部配置,可通过重新验证重试。失败原因区分网络不可达、端口不通、超时与 API 鉴权失败。
说明:
验证操作不会自动创建接入点,也可以跳过验证直接创建,之后在详情页检查连接状态。创建时系统保存与当前配置对应的验证结果;VPC、专线、VPN 验证通过后,详情页连接状态显示已连接,未执行验证时显示待验证。
更换地域、网络类型、网关、VPC、子网、模型 Base URL 或模型 API Key 后,原验证结果失效;进行中的旧检查不会覆盖新配置的验证结果。

步骤四:确认压缩状态

在上下文压缩区域确认压缩开关,字段下方说明为压缩请求中的上下文,减少输入 Token,降低模型调用成本。开关默认开启并显示已开启,费用为限时免费。创建后可在接入点详情中关闭或恢复;关闭后接入点仍可正常调用模型,但不再压缩上下文。


步骤五:提交创建

1. 核对基本信息中的地域、接入点名称,以及模型接入中的模型来源、模型信息与网络信息。
2. 单击创建接入点。系统校验模型信息及当前网络类型的必填配置,字段缺失或资源归属关系不合法时提示原因并保留表单。
3. 创建成功后,在接入点列表中查看资源,进入详情获取访问 URL 和 API Key。

后续操作