自定义接入点(Endpoint)成本拆分迁移指南
1. 背景与目标
为了向企业提供更灵活、更细颗粒度的成本管理能力,百度千帆大模型平台将于 4月1日 00:00 正式上线基于「自定义接入点(Endpoint)」的成本拆分功能,届时原有的基于「应用(AppID)」维度的成本拆分功能将同步下线。
为确保您的业务平滑过渡、账单数据无缝衔接,平台特制定本迁移指南,建议您合理规划技术改造时间。
2.迁移操作
阶段一:过渡期(4月1日 00:00 前)
目前,用户通过为不同业务线分配不同的 AppID 来实现成本核算。自定义接入点拆帐上线后,「成本拆分」中的账单将按照「自定义接入点」维度进行拆分。如果您还需使用「成本拆分」功能,请尽快将模型调用切换为「自定义接入点(Endpoint)」调用,具体操作见:自定义接入点操作指南。
考虑到企业级业务通常存在多个调用场景,开发团队无法在短时间内完成所有业务代码的集中改造与发版上线。为保障业务连续性,平台特设立此平滑过渡期(即日起至4月1日),供您进行代码替换与灰度测试。在此期间,平台账单系统将进行向下兼容,继续维持原有的按 AppID 维度的成本拆分,以确保您的内部财务核算与对账流程不发生断层。
-
开发者改造动作:
- 在控制台控制台为不同业务线或使用场景创建独立的「自定义接入点(Endpoint)」,并绑定对应的模型服务。
- 修改代码逻辑:将原 API 请求中的 model 参数替换为新建的自定义接入点(如 ep_111_deepseek-v3.2),同时继续保留传入 appid 参数。
- 账单表现(兼容聚合):过渡期内,您在「成本拆分」模块看到的依然是按 AppID 拆分的账单。对于已切换为接入点调用的请求,系统会自动将其费用向上聚合并计入其绑定的预置模型服务计费项中。
计费逻辑示例(以下图 中 AppID-333 为例):
拆分项 appid-333 下的 kimi-k2.5 计费项费用 = 该 AppID 下直接调用基础模型的费用(此时没有发生实际调用,因此为0) + 该 AppID 下调用所有绑定在该模型上的自定义接入点(如 ep_666_kimi-k2.5 + ep_777_kimi-k2.5 )的费用总和。

阶段二:正式上线(4月1日 00:00 起)
核心变化:应用(AppID)维度 拆账正式下线,全面启用基于接入点维度的精准拆账。
- 平台变更: 「成本拆分」模块中,原有的 AppID 拆分项将不再生效。自定义接入点(Endpoint)将直接作为独立的成本拆分项。其金额精准对应实际调用该接入点产生的费用。
-
账单管理最佳实践:上线后,企业财务/IT 运维人员可通过建立“接入点 - 业务线”的映射关系进行成本归集。
- 以业务线1为例,通过创建并管理 接入点ep_111_deepseek-v3.2、ep_222_kimi-k2.5、ep_333_ernie-5.0-thinking-preview。在最终成本拆分中对接入点ep_111_deepseek-v3.2、ep_222_kimi-k2.5、ep_333_ernie-5.0-thinking-preview三项拆分项费用加和即为该业务线的费用之和。

3. 开发者行动建议 (Action Items)
- 梳理业务线与模型需求: 盘点当前使用不同 AppID 的业务方,规划需要创建的自定义接入点清单。
- 创建接入点并替换调用: 登录千帆控制台创建相应的自定义接入点,并在 4月1日之前 完成代码层的 API 入参替换。
- 财务对齐: 提前与内部财务/账单管理员沟通计费维度的变更,确立 4月1日后以「自定义接入点」进行内部结算的新流程。
- APIkey粒度的接入点权限控制(可选): 除此之外,根据需求可以通过配置 API Key 所关联的应用(AppID)和自定义接入点(Endpoint)以实现API Key的权限细粒度控制,具体操作见 API key操作指南。
4. 常见问题
Q:我目前采用的是V1接口调用模型服务,想在功能更新后继续体验成本拆分功能,应当如何做改造?
A: 您首先应当切换至推理服务API V2版本,具体使用方法见:推理服务API V2,其次切换至自定义接入点调用模型服务,自定义接入点指南见:自定义接入点,切换后,在过渡期间您可以参照第二章节内容实现平滑过渡。
评价此篇文章
