操作场景
本文介绍如何查看接入点信息、获取连接地址、管理上下文压缩、修改模型与网络配置,以及停用或删除接入点。
接入点的配置分为三块:基本信息(地域、名称、状态)、模型接入(模型来源、接入方式、模型地址与凭证、网络)与上下文压缩。详情页按同样顺序展示,各块右上角提供对应的修改入口。
查看接入点
1. 登录 ContextTurbo 控制台。
2. 在左侧导航栏中选择接入点管理。
3. 选择接入点所在地域。
4. 按接入点名称或 ID 筛选目标资源。

列表按列展示以下信息。
列名 | 说明 |
接入点 ID / 名称 | 用于识别接入点。资源 ID 以 ept- 开头,下方为接入点名称。 |
模型来源 | 接入点所用模型服务的来源,取值为免费体验或已有模型接入。 |
所属网络 | 接入点访问模型服务所用的网络类型,如腾讯云 VPC 私网。使用平台免费额度或通过公网访问模型时显示为 -。 |
上下文压缩 | 当前是否开启压缩,取值为已开启或已关闭。 |
状态 | 接入点当前是否可用,取值为可用或已停用。 |
连接地址 | 展示公网 URL 和内网 URL,可直接复制。两类地址指向同一接入点,共用 API Key。 |
操作 | 查看详情、查看用量、停用、删除。接入点使用免费体验额度时,另提供开通模型资源入口。 |
5. 在操作列单击查看详情,进入接入点详情页。

说明:
详情页由基本信息、模型接入、上下文压缩、快速接入四个区域组成。各区域右上角提供对应的修改入口。
页头左侧显示接入点 ID(接入点名称),单击返回箭头可回到接入点列表。
获取连接地址
连接地址在详情页快速接入区域展示,也同步展示在接入点列表的连接地址列。按调用环境选择公网 URL 或内网 URL。

字段 | 说明 |
公网 URL | 在能够访问公网服务的调用环境中使用。 |
内网 URL | 在具备对应内网连通条件的环境中使用。页面提示内网和公网访问同一个接入点,共用 API Key。内网地址需在具备内网连通条件的环境中使用。 |
API Key | 单击获取 Key 查看,或单击重置 Key 更换。重置后原 Key 立即失效。 |
支持的模型 | 使用免费体验额度时展示,用于选择该接入点可调用的模型。 |
Model ID | 已有模型接入时展示,用于填写上游支持的模型 ID,作为 cURL 示例中的 model 参数值。 |
cURL 连通性测试区域提供可直接复制的请求示例,默认勾选当前接入点的公网 URL。单击复制请求时会自动获取 API Key 并补全
Authorization,返回 HTTP 200 表示调用成功。说明:
快速接入区域提供 API 接入与 AI 工具接入两个页签,分别给出命令行与 AI 工具的接入示例。接口路径和鉴权方式应与示例保持一致。
查看网络配置与连接状态
模型来源为已有模型接入、且通过 API 接入访问模型的接入点,详情页的模型接入区域会展示模型配置与网络配置,并支持连接验证。

模型配置包含以下字段。
字段 | 说明 |
模型来源 | 接入点使用哪一类模型服务,取值为免费体验或已有模型接入。 |
接入方式 | API 接入或透传模式。透传模式下地址与凭证随请求 Header 传入,接入点不保存。 |
接入平台 | 模型服务的提供方,如自定义接入、腾讯云 TokenHub。 |
模型 Base URL | 模型 API 的访问地址。透传模式下不展示取值。 |
模型 API Key | 仅展示配置状态(已配置/未配置),不回显明文。 |
网络配置在接入方式为 API 接入时展示,包含以下字段。
字段 | 说明 |
模型服务网络类型 | 接入点访问模型服务所用的网络,取值为公网、腾讯云 VPC 私网、专线接入或 VPN 接入。 |
所属 VPC | 腾讯云 VPC 私网、专线、VPN 接入时展示,以名称 · ID 形式呈现,便于核对。 |
子网 | 展示已选子网,未选择时显示未配置。 |
连接状态 | 待验证或已连接。单击验证连接基于当前保存的网络、模型地址和凭证发起检查。 |
未执行验证时显示待验证,并提示当前配置尚未验证,点击验证连接发起检查;验证通过后显示已连接。
关闭或恢复上下文压缩
说明:
关闭上下文压缩与停用接入点是两种操作。关闭压缩后仍可通过接入点调用模型;停用会影响通过该接入点发起的后续调用。
1. 进入目标接入点详情。
2. 在上下文压缩区域单击启用状态旁的开关,按页面提示完成操作。
3. 确认新的压缩状态,并使用业务请求验证。

区域右侧展示限时免费标签。字段下方说明为压缩请求上下文,减少输入 Token;关闭后按原请求转发。
关闭压缩后,接入点按原请求转发至模型服务。恢复压缩后,后续请求按压缩流程处理。
修改接入点配置
在接入点详情页,可分别修改三类配置:
修改对象 | 入口 |
接入点名称 | 在基本信息区域单击接入点名称旁的修改。 |
模型与网络配置 | 在模型接入区域右上角单击修改配置。 |
上下文压缩 | 在上下文压缩区域切换启用状态,无需进入弹窗。 |
修改模型配置
单击模型接入区域右上角的修改配置,打开修改模型配置弹窗,可统一调整模型来源、接入方式、模型地址与凭证,以及网络信息。

1. 在接入点详情页的模型接入区域,单击右上角修改配置。
2. 弹窗回填当前配置:模型来源、服务商、接入方式、模型 Base URL,以及网络信息中的所属网络与网络资源。模型 API Key 展示为占位提示已配置;留空保留,输入新 Key 替换。
3. 按需调整模型来源与服务商。切换模型来源会重置下方字段;接入方式在 API 接入与透传模式间切换时,地址与凭证的保存方式随之变更。
4. 所属网络支持在公网、腾讯云 VPC 私网、专线接入、VPN 接入之间切换,资源选择与联动规则与创建时一致。切换网络类型会清理原网络类型的专属配置。
5. 按以下规则填写模型 API Key。
场景 | 填写方式 |
模型 Base URL 未变更 | 留空保留原 Key,填写新 Key 则替换。 |
更换模型 Base URL | 需重新填写模型 API Key。 |
6. 可先单击验证连通性,确认模型 API 可访问且凭证有效后,再单击保存模型配置。
保存时系统校验字段与资源归属关系。字段缺失或归属关系不合法时提示原因并保留表单供修正;接入点 ID、API Key、标签和历史请求保持不变。
说明:
修改网络类型、专线网关、VPN 网关、VPC、子网、模型 Base URL 或模型 API Key 后,原验证结果失效,连接状态回到待验证,可再次单击验证连接;保存未变更的配置时,原有验证状态保留。
单击取消或关闭弹窗将放弃本次修改,原配置与连接状态保持不变。
连接状态说明
状态 | 含义与操作 |
待验证 | 当前配置尚未验证,可单击验证连接发起检查。 |
已连接 | 当前配置已通过模型 API 可达性与鉴权检查,可再次单击验证连接。 |
连接失败:网络不可达 | 展示失败原因与检查方向,如模型 API 端口、VPC 路由、安全组放通;修正后再次验证。 |
连接失败:鉴权失败 | 检查模型 API Key 与模型权限,可通过修改配置修正后再次验证。 |
说明:
验证结果与本次检查的配置对应,旧配置的异步验证结果不会覆盖新配置的状态。
停用接入点
不再需要某个接入点接受调用时,可在接入点列表中单击停用。停用前应检查业务调用方,并完成流量切换,避免影响正在使用该接入点的业务。
确认弹窗标题为停用接入点「接入点名称」?说明为停用后停止新的调用,保留配置和历史用量。单击确定后接入点状态变更为已停用。

删除接入点
警告:
删除后,调用方不能继续依赖原接入点配置访问服务。删除操作不可恢复,请在操作前确认所有调用方已完成迁移。
1. 在接入点列表中找到目标资源。
2. 确认业务应用、模型网关和 AI 工具已不再使用该接入点。
3. 单击删除,阅读页面提示后完成操作。
确认弹窗标题为删除接入点「接入点名称」?说明为删除后立即失效,无法恢复;历史用量仍保留在用量统计中。

查看接入点用量
相关文档
创建接入点
常见问题