API Keys
创建、管理和吊销 Praxis API Key。
API Key 是你调用 Praxis API 的凭证——sk-praxis- 开头的一串字符。每个 Key 属于一个账户空间,通过它产生的调用都记在那个空间名下。
创建 Key
- 打开 控制台 → API Keys
- 点「创建 Key」
- 填写:
| 字段 | 说明 |
|---|---|
| 名称 | 必填,用于识别用途(如 prod-backend、my-app) |
| 有效期 | 30 / 60 / 90 天或永久,默认 90 天 |
- 点「创建」
创建成功后弹窗会展示完整 Key 并带「复制 Key」按钮——立即复制保存。关闭弹窗后列表只显示掩码,但你可以随时点行内复制图标重新获取完整 Key。
管理 Key
在 API Keys 列表页,你可以:
- 复制:悬停 Key 行,点复制图标取回完整 Key
- 禁用:临时停用某个 Key(不删除,之后可重新启用)
- 删除:永久移除——已删除的 Key 立即失效,无法恢复
安全实践
- 不要把 Key 写进代码——用环境变量(
export PRAXIS_API_KEY=sk-praxis-…) - 不同环境用不同 Key——开发/测试/生产各自一个,出问题时只吊销受影响的那个
- 定期轮换——长期运行的系统建议每 90 天换新 Key
- 泄露了怎么办:立即删除该 Key,创建新的,更新你的应用
常见问题
| 症状 | 原因 | 解法 |
|---|---|---|
| 401 Invalid API key | Key 已删除/禁用,或复制不完整 | 到控制台确认 Key 状态;重新完整复制 |
| Key 到期了怎么办 | 有效期到了 | 创建新 Key 并更新到你的应用 |
| 能创建多少个 Key | — | 每个账户空间可创建多个 Key,按需管理 |