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

# 创建 API 密钥

> 在控制台创建一个 sk- 开头的令牌并配置权限

API 密钥(令牌)是所有 API 调用的身份凭证。建议为每个应用 / 环境单独创建一把,便于细粒度管控。

## 创建令牌

1. 登录 [openp.ai](https://openp.ai) 后,进入控制台 → **令牌(Tokens)**。
2. 点击右上角 **添加新的令牌**。
3. 填写令牌配置:

| 字段     | 必填 | 说明                                    |
| ------ | -- | ------------------------------------- |
| 名称     | 是  | 仅用于自己识别,例如 `my-app-prod`、`local-dev`。 |
| 额度     | 否  | 该令牌允许消耗的最大金额。`-1` 表示无限制。              |
| 过期时间   | 否  | 留空表示永不过期。临时测试令牌建议设置较短期限。              |
| 模型范围   | 否  | 允许该令牌调用的模型 ID 列表。留空表示账号下所有模型。         |
| IP 白名单 | 否  | 仅允许来自指定 IP 的请求(逗号分隔)。                 |
| 分组     | 否  | 指定该令牌走的分组通道(影响倍率与上游)。                 |

4. 点击 **提交**。系统将生成一个形如下面的密钥:

```
sk-J5g0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

<Warning>密钥仅在创建瞬间完整展示一次。请立即复制保存到密码管理器或环境变量,**关闭页面后无法再次完整查看**(只能看到首尾片段)。</Warning>

## 妥善保存密钥

推荐做法:

* **本地开发**:写入 `.env` 文件并加入 `.gitignore`。
* **生产环境**:使用 Vault、AWS Secrets Manager、Doppler 等密钥管理服务。
* **CI/CD**:作为 GitHub Actions / GitLab Secret 注入。
* **绝不提交到 Git 仓库**或粘贴到聊天 / Issue 中。

```bash .env theme={null}
OPENPAI_API_KEY=sk-J5g0xxxxxxxxxxxxxxxxxxxxxxxxxx
OPENPAI_BASE_URL=https://openp.ai/v1
```

## 管理已有令牌

在 **令牌列表** 中可对每个令牌执行:

* **复制**:再次复制完整密钥(仅在创建后短期内可用)。
* **编辑**:修改名称、额度、过期时间、模型范围。
* **禁用 / 启用**:临时停用而不删除。
* **删除**:永久作废,使用该密钥的请求将立即返回 `401`。

<Tip>若怀疑某把密钥泄露,请立即点击 **禁用** 或 **删除**,然后创建新密钥替换。已发生的非授权消耗可通过工单申请审查。</Tip>

## 验证密钥可用

```bash theme={null}
curl https://openp.ai/v1/models \
  -H "Authorization: Bearer $OPENPAI_API_KEY"
```

若返回模型列表 JSON,说明密钥工作正常。
若返回 `401`,请检查密钥是否复制完整、是否被禁用、是否超过过期时间。

## 下一步

<CardGroup cols={2}>
  <Card title="账户充值" icon="wallet" href="/getting-started/top-up">
    充值额度后可调用全部付费模型。
  </Card>

  <Card title="发出第一个请求" icon="paper-plane" href="/getting-started/first-request">
    用刚创建的密钥发起 Chat Completion。
  </Card>
</CardGroup>