Question 1

如何创建 API Key？

Accepted Answer

1. 登录开发者控制台 2. 选择目标组织与项目 3. 进入 API Key 页面，点击「创建 API Key」 4. 为 Key 命名（建议标注用途，如 `prod-backend`） 5. 创建成功后，立即复制并安全保存完整密钥 Key 格式通常为 `sk-snx-...`，调用时在请求头携带：`Authorization: Bearer <YOUR_KEY>`。 相关：认证 · 控制台 API Key

Question 2

为什么完整密钥只显示一次？

Accepted Answer

这是出于安全设计：平台只存储密钥的哈希值，无法在创建后再次展示明文。若遗失完整密钥，无法找回，只能销毁旧 Key 并创建新 Key。 建议：创建后立即写入密钥管理服务或环境变量，切勿提交到代码仓库。

Question 3

Key 销毁或过期后会怎样？

Accepted Answer

销毁或过期后，使用该 Key 的请求将返回 401，错误码 `invalid_api_key`。调用不会被计费。 请检查：Key 是否已销毁、是否设置了过期时间、请求头格式是否为 `Bearer <key>`（注意空格）。 相关：认证 · 错误处理

Question 4

生产/测试环境如何隔离？

Accepted Answer

建议按以下方式隔离： - 分项目：为 dev、beta、prod 各建独立项目 - 分 Key：每个环境使用独立 API Key，便于用量区分与单独设置花费上限 - 分环境变量：在 CI/CD 与运行时分别注入对应 Key，避免混用 切勿在测试环境使用生产 Key，或在日志中打印完整密钥。

API Key 管理