> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigmodel.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# API Key 分类管理说明

> 帮助您快速了解模型标准 API 与 GLM Coding Plan 套餐的 API Key 分类管理方式、新建 Key 的入口选择及历史 Key 的处理规则。

> 公告发布时间：2026 年 10 月 16 日<br />

自 2026 年 10 月 16 日起，模型标准 API（按量计费／资源包）与 GLM Coding Plan 套餐的 API Key 分开管理。新建 API Key 时，请根据需要使用的额度选择对应入口；历史 API Key 由系统分类处理，无需统一更换。

<Tip>
  **要点概览**

  * **已经在用的 Key 无需更换**，历史 Key 由系统自动分类，密钥值保持不变
  * **以后新建 Key 按用途选入口**：标准 API Key、个人套餐 Key、团队套餐 Key 互不通用
  * **历史兼容 Key 使用哪类额度取决于调用端点**，与它显示在哪个列表无关
</Tip>

## 一、应该使用哪种 API Key

| 使用需求 | 选择的 Key | 获取入口与计费方式 |
| :- | :- | :- |
| 按量付费或使用普通资源包 | 标准 API Key | 在[标准 API Key 页面](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)创建，使用账户余额或适用的普通资源包，不消耗 Coding Plan 套餐额度。 |
| 使用个人 Coding Plan 套餐 | 个人套餐 API Key | 在[个人编程套餐 → 套餐概览](https://bigmodel.cn/coding-plan/personal/overview)获取，消耗个人套餐额度。 |
| 使用团队 Coding Plan 套餐 | 团队套餐 API Key | 在[团队编程套餐 → 我的套餐](https://bigmodel.cn/coding-plan?z_plan=team)获取，按团队套餐及席位规则使用额度。 |

**对于即日起新建的标准 Key 和套餐 Key，使用哪类额度由 Key 类型决定**。在支持的调用端点中标准 Key 按标准 API 规则计费，套餐 Key 按对应套餐规则使用；切换调用地址不会改变 Key 的计费用途。

> 例如，在编程工具中使用标准 API Key，即使账号已订阅 Coding Plan，也不会消耗套餐额度，仍可能产生按量费用，扣减账户余额。

## 二、历史 API Key 如何处理

2026 年 10 月 16 日前创建的 API Key，系统会按以下规则整理，**密钥值保持不变，无需因本次分类调整重新配置已有 Key**：

| 历史 Key 所属情况 | 分类结果 | 后续使用方式 |
| :- | :- | :- |
| 属于团队套餐项目 | 团队套餐 Key | 按团队套餐及席位规则使用。 |
| 所属账号曾购买过或拥有过生效套餐，且不属于团队套餐项目 | 兼容 Key | 保留原有使用及计费规则。详见 [兼容 Key 的使用与计费规则](#兼容-key-的使用与计费规则) |
| 所属账号从未拥有过套餐 | 标准 Key | 按标准 API 规则计费。 |

部分企业专属服务及合作商渠道的历史 Key 保留原有兼容方式，以控制台展示及原服务约定为准。

### 兼容 Key 的使用与计费规则

历史 Key 显示**兼容**标签，表示其原有调用方式和计费规则保持不变，您可继续按原方式使用。**对于历史兼容 Key，使用哪类额度取决于“调用端点”及“账号是否曾拥有过 Coding Plan 套餐”，与它显示在哪个列表无关。**

常见接入地址及计费方式如下：

| 调用方式 | Base URL（工具中配置的基础地址） | 兼容 Key 使用的额度 |
| :- | :- | :- |
| OpenAI Chat Completions - 标准 API | `https://open.bigmodel.cn/api/paas/v4` | 账户余额或适用的普通资源包，不消耗 Coding Plan 套餐额度。 |
| OpenAI Chat Completions - 套餐端点 | `https://open.bigmodel.cn/api/coding/paas/v4` | 如果曾拥有过 Coding Plan 套餐，将消耗套餐额度（套餐到期后会中断服务）；<br />未曾拥有过 Coding Plan 套餐，将消耗账户余额或适用的普通资源包 |
| Anthropic Messages - 通用 | `https://open.bigmodel.cn/api/anthropic` | 如果曾拥有过 Coding Plan 套餐，将消耗套餐额度（套餐到期后会中断服务）；<br />未曾拥有过 Coding Plan 套餐，将消耗账户余额或适用的普通资源包 |
| OpenAI Responses - 通用 | `https://open.bigmodel.cn/api/v1` | 如果曾拥有过 Coding Plan 套餐，将消耗套餐额度（套餐到期后会中断服务）；<br />未曾拥有过 Coding Plan 套餐，将消耗账户余额或适用的普通资源包 |

> 例如，账号当前有可用 Coding Plan 套餐时，同一把历史兼容 Key，配置为 `https://open.bigmodel.cn/api/coding/paas/v4` 时使用套餐额度；改为 `https://open.bigmodel.cn/api/paas/v4` 后，则按标准 API 规则计费，**即使套餐仍有剩余额度，也可能消耗账户余额**。

## 三、常见问题

### 1. 这次调整对我有什么影响？需要重新配置吗？

* **已经在用的 Key，可以继续用。** 无需因本次调整更换 Key，也不用重新配置工具。

* **以后新建 Key，要按用途选入口。** 想用 Coding Plan 套餐额度，就到[个人](https://bigmodel.cn/coding-plan/personal/overview)或[团队](https://bigmodel.cn/coding-plan?z_plan=team)套餐页面获取套餐 Key；想按量付费或使用普通资源包，就到[标准 API Key](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) 页面创建。

### 2. 买了套餐，为什么仍然消耗余额

请检查工具中实际配置的 Key：**标准 Key 不使用 Coding Plan 额度；个人历史兼容 Key 通过标准 API 端点调用，也会按标准 API 规则计费**。如需使用套餐额度，请从对应套餐入口获取套餐 Key，并替换工具中的 Key。接入配置可参考[快速开始](/cn/coding-plan/quick-start)。

### 3. 历史兼容 Key 在套餐到期后，如何切换为按量计费

套餐到期后，历史兼容 Key 在套餐端点上的调用不会自动转为按量计费。如需继续使用：

1. 前往[标准 API Key 页面](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)，创建标准 API Key。

2. 将工具或应用中配置的兼容 Key 替换为新建的标准 Key，**原调用地址可保持不变**。

请确保账户有可用余额或适用的普通资源包。切换后，后续调用按标准 API 规则计费，不再使用 Coding Plan 套餐额度。

团队套餐已配置的超额付费继续按原规则执行；是否产生额外费用，以团队的超额付费设置为准。

### 4. 为什么看不到个人 Coding Plan Key 入口

个人 Coding Plan Key 入口仅在已开通个人套餐的账号下、默认组织的默认项目中展示。请检查当前组织和项目；团队套餐成员请前往[团队编程套餐 → 我的套餐](https://bigmodel.cn/coding-plan?z_plan=team)获取团队套餐 Key。

如 Key 的展示或调用结果与预期不符，请联系[技术支持](https://bigmodel.cn/online-book/customerService)，并提供报错信息及请求 ID。请勿发送完整 API Key，注意妥善保管。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.