跳到正文
九维AI开放平台使用文档

问题排查

API Key 安全与账户管理:撤销、环境变量和脱敏反馈

为工具使用独立密钥,避免把密钥写进公开代码和截图,说明泄漏后的撤销与账户管理步骤。

成都九维数创科技有限公司 · 文档团队更新于 约 4 分钟阅读
本页目录
  1. 按用途创建密钥
  2. 密钥只用于可信工具
  3. 程序使用环境变量
  4. 发现泄漏后怎么做
  5. 账户与反馈

按用途创建密钥#

为不同工具或程序创建有明确名称的密钥,必要时设置模型白名单和 RPM。这样停用一个工具时,可以撤销对应密钥,不必影响所有客户端。

密钥只用于可信工具#

完整 API Key 不应出现在公开网页脚本、仓库、群聊或教程截图中。浏览器公开前端应由自己的后端代理请求,不能把真实密钥写入 JavaScript。

桌面工具中按官方配置入口保存密钥,避免将本站密钥输入不明网站或与本站无关的供应商默认地址。

程序使用环境变量#

业务后端可以从环境变量或密钥系统读取 API Key。示例文件仅保留占位值;日志记录请求 ID和错误状态,不打印 Authorization 头。

发现泄漏后怎么做#

  1. 在API 密钥撤销泄漏密钥。
  2. 创建新的专用密钥,并更新实际使用的工具或程序。
  3. 查看泄漏期间的用量,核对异常模型、时间和费用。
  4. 需要帮助时提交工单,说明时间与对应密钥前缀,不要再次粘贴完整密钥。

仅删除截图或撤回消息不能让已泄漏密钥失效。

账户与反馈#

设置独立的登录密码,退出不使用的会话。反馈时可保留状态码、模型 ID和请求 ID,但应隐藏完整密钥、敏感原始材料和支付信息。

模型资源授权只控制账户可用范围,不应被当作泄漏后的替代处理;需要直接撤销泄漏密钥。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground