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

# API密钥获取与管理

> 说明如何在老张API控制台获取、复制和管理 API Key，避免令牌权限配置错误，并了解默认令牌、新建令牌和密钥安全注意事项。

## 简短答案

登录老张API控制台后，进入顶部导航的「令牌」页面即可复制默认 API Key。KEY 通常以 `sk-` 开头；如果要做项目隔离、团队协作或限制单个项目额度，可以新建独立 API Key。创建新 KEY 时如无特殊限制，通常不需要填写可用模型，避免把令牌误限制到少数模型。

## 获取API密钥（默认令牌）

1. 进入顶部导航的"令牌"页面：[https://api2.laozhang.ai/token](https://api2.laozhang.ai/token)

2. 在页面中找到默认令牌，点击最右侧的管理菜单

3. 在管理菜单中找到复制图标，点击复制

4. 复制出完整的 KEY，KEY 的格式是以 `sk-` 开头

<img className="block dark:hidden" src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/key-manage.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=b13128e022086941ff76a4346c7a992f" alt="复制API Key" width="1466" height="1006" data-path="images/key-manage.png" />

<img className="hidden dark:block" src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/key-manage.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=b13128e022086941ff76a4346c7a992f" alt="复制API Key" width="1466" height="1006" data-path="images/key-manage.png" />

## 创建新的API密钥

除了使用默认令牌，您也可以创建新的 KEY 来精准控制使用权限：

<img className="block dark:hidden" src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/key-add-new.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=baab7d5a4d50d8a6ebaaff3b49519249" alt="新增API Key" width="1284" height="1158" data-path="images/key-add-new.png" />

<img className="hidden dark:block" src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/key-add-new.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=baab7d5a4d50d8a6ebaaff3b49519249" alt="新增API Key" width="1284" height="1158" data-path="images/key-add-new.png" />

### 创建新的API密钥的优势

* **余额控制**：可以为每个 KEY 设置专门的余额限制
* **有效期管理**：可以设置 KEY 的过期时间
* **灵活分配**：适合团队使用或项目隔离

<Warning>
  **重要提示**：创建新 KEY 时，**不需要设定可用模型**。

  这里采用白名单机制：

  * **如果设置了可用模型**：该 KEY 只能使用指定的模型
  * **如果不设置可用模型**：该 KEY 默认继承当前账户分组可访问的模型范围

  如果只是正常接入，推荐先不要设置可用模型；如需做项目隔离或限制调用范围，再按实际需要配置模型白名单。
</Warning>

## KEY格式说明

* 所有 API KEY 都以 `sk-` 开头
* KEY 长度通常为 48-64 位字符
* 请妥善保管您的 KEY，不要在公开场所分享

## 使用建议

1. **开发测试**：使用默认令牌进行快速开发和测试
2. **生产环境**：为生产项目创建专门的 KEY，便于管理和监控
3. **团队协作**：为不同团队成员创建独立的 KEY，方便权限管理

## 密钥异常或疑似泄露时

如果 API Key 无法使用、权限范围不符合预期，或怀疑密钥已经泄露，请先在控制台停用或重新生成相关 KEY，再更新业务系统中的环境变量。

联系技术支持时，请提供：

* 账号邮箱或用户名
* API Key 的备注名、创建时间或用途说明
* 日志页中的请求时间、模型 ID 和错误信息
* 是否最近修改过可用模型、余额限制或有效期

不要通过邮件、工单或聊天窗口发送完整 API Key；如需定位，请只提供前后少量字符并打码中间部分。

## 相关问题

* 如果账户还有余额但请求失败，请先查看[为什么还有余额跑不通？](/faq/balance-insufficient)
* 如果需要通过接口监控额度，请查看[如何通过API查询账户余额](/faq/balance-query-api)
* 如果要核对某次调用的模型和计费，请查看[如何查看我的调用记录？](/faq/call-logs)