创建和保护 API Key

API Key 代表你的账号调用 OptiWaves API。完整密钥只在创建后显示一次，请将它存入私密环境变量或密钥管理器。

创建密钥

1. 打开 API 密钥。
2. 输入便于识别的名称，例如 production_backend。
3. 根据需要设置允许的模型、花费上限和到期时间。
4. 创建后立即复制完整密钥。
5. 关闭弹窗前，用 GET /v1/models 验证密钥。

限制密钥

可以对每把有效密钥设置以下设置：

每把密钥只能使用账号套餐允许的模型和额度。最多可保留 8 把有效密钥，达到上限时先撤销不再使用的密钥。

轮换密钥

1. 创建一把具有同等或更少权限的新密钥。
2. 更新客户端或服务端的 API Key。
3. 用新密钥调用 /v1/models 和一次最小请求。
4. 确认新密钥可用后，撤销旧密钥。

撤销会立即生效，已撤销密钥不能恢复成有效状态。

安全要求

• 不要将密钥提交到 Git，也不要写进浏览器前端包
• 不要在日志、截图、聊天或工单中粘贴完整密钥
• 为测试、生产和不同服务创建不同密钥
• 只允许实际需要的模型，并设置合理的花费和到期限制

下一步

• 使用 SDK 开发
• 排查 API 错误与限制