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

管理接入点

最近更新时间:2026-10-28 17:46:00
我的收藏

操作场景

本文介绍如何查看接入点信息、获取连接地址、管理上下文压缩、修改模型与网络配置,以及停用或删除接入点。
接入点的配置分为三块:基本信息(地域、名称、状态)、模型接入(模型来源、接入方式、模型地址与凭证、网络)与上下文压缩。详情页按同样顺序展示,各块右上角提供对应的修改入口。

查看接入点

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. 单击删除,阅读页面提示后完成操作。
确认弹窗标题为删除接入点「接入点名称」?说明为删除后立即失效,无法恢复;历史用量仍保留在用量统计中。


查看接入点用量

在接入点列表中单击查看用量,或进入详情页在基本信息的接入点 ID 旁单击查看用量,进入对应的用量统计页面。具体指标请参见 查看用量与节省效果。

相关文档