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

​
创建令牌

  1. 登录 openp.ai 后,进入控制台 → 令牌(Tokens)。
  2. 点击右上角 添加新的令牌。
  3. 填写令牌配置:
字段必填说明
名称是仅用于自己识别,例如 my-app-prod、local-dev。
额度否该令牌允许消耗的最大金额。-1 表示无限制。
过期时间否留空表示永不过期。临时测试令牌建议设置较短期限。
模型范围否允许该令牌调用的模型 ID 列表。留空表示账号下所有模型。
IP 白名单否仅允许来自指定 IP 的请求(逗号分隔)。
分组否指定该令牌走的分组通道(影响倍率与上游)。
  1. 点击 提交。系统将生成一个形如下面的密钥:
sk-J5g0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
密钥仅在创建瞬间完整展示一次。请立即复制保存到密码管理器或环境变量,关闭页面后无法再次完整查看(只能看到首尾片段)。

​
妥善保存密钥

推荐做法:
  • 本地开发:写入 .env 文件并加入 .gitignore。
  • 生产环境:使用 Vault、AWS Secrets Manager、Doppler 等密钥管理服务。
  • CI/CD:作为 GitHub Actions / GitLab Secret 注入。
  • 绝不提交到 Git 仓库或粘贴到聊天 / Issue 中。
.env
OPENPAI_API_KEY=sk-J5g0xxxxxxxxxxxxxxxxxxxxxxxxxx
OPENPAI_BASE_URL=https://openp.ai/v1

​
管理已有令牌

在 令牌列表 中可对每个令牌执行:
  • 复制:再次复制完整密钥(仅在创建后短期内可用)。
  • 编辑:修改名称、额度、过期时间、模型范围。
  • 禁用 / 启用:临时停用而不删除。
  • 删除:永久作废,使用该密钥的请求将立即返回 401。
若怀疑某把密钥泄露,请立即点击 禁用 或 删除,然后创建新密钥替换。已发生的非授权消耗可通过工单申请审查。

​
验证密钥可用

curl https://openp.ai/v1/models \
  -H "Authorization: Bearer $OPENPAI_API_KEY"
若返回模型列表 JSON,说明密钥工作正常。 若返回 401,请检查密钥是否复制完整、是否被禁用、是否超过过期时间。

​
下一步

账户充值

充值额度后可调用全部付费模型。

发出第一个请求

用刚创建的密钥发起 Chat Completion。