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

# 创建与保护 API Key

> 创建调用凭证，隔离应用并安全轮换密钥。

APIONE API Key 是模型调用凭证，不是控制台登录密码。取得密钥后，在服务端通过请求头发送，避免泄露到浏览器、截图或日志。

![APIONE API Key 创建入口与分组选择](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/api-keys-overview.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=286a882ab53c81ad3bd16d56c6487dc9)

先确认 Base URL 和分组，再创建业务使用的 API Key。

## 创建与保存

1. 登录 [APIONE 控制台](https://apione.ai/zh/app)。
2. 打开 [API 密钥页](https://apione.ai/zh/app/api-keys)，创建业务使用的密钥。
3. 按控制台可选项设置模型范围、计费分组与有效期。密钥显示后，将完整内容保存到密钥管理器。
4. 用[快速开始](https://apione.ai/docs/quickstart.md)发送最小请求，确认权限。

## 分组与权限

密钥选择的分组决定可用模型及对应价格。创建或修改密钥后，先用 `GET /v1/models` 查询当前可用 ID，再发送业务请求。详见[模型查询](https://apione.ai/docs/models/catalog.md)与[分组定价](https://apione.ai/docs/account/usage.md)。

## 请求鉴权

OpenAI 兼容接口使用 `Authorization: Bearer YOUR_APIONE_KEY`。Anthropic 兼容接口可使用 `x-api-key`。一次请求只选择一种鉴权凭证，不要同时发送多个鉴权头。

## 推荐做法

* 为开发、测试、生产分别使用密钥，便于定位用量与轮换。
* 使用环境变量或服务端密钥管理服务，不把密钥放入前端代码或公开配置。
* 日志只记录密钥别名或脱敏标识，不记录完整请求鉴权头。
* 出现泄露时先在控制台停用或撤销旧密钥，再配置新密钥并验证业务恢复；以界面实际提供的管理操作为准。

## 轮换检查单

部署新密钥后检查健康请求、模型权限和错误率；确认所有实例已切换后处理旧密钥。如果切换失败，不要通过工单或聊天发送真实密钥，请提供请求 ID 和脱敏配置。

相关：[用量与费用](https://apione.ai/docs/account/usage.md)、[联系支持](https://apione.ai/docs/support/contact.md)。


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