API 密钥管理

创建和保存

在控制台创建密钥，将其保存到可信密码管理器或服务端环境变量。根据密钥编辑页实际提供的选项，设置有效期、可用模型或额度限制。

export NEON_API_KEY="YOUR_API_KEY"

OpenAI 兼容请求使用 Authorization: Bearer YOUR_API_KEY。Anthropic 兼容客户端可通过其认证令牌配置使用本站密钥；具体请求头见对应协议参考。

保护密钥

不要把密钥放进浏览器 JavaScript、公开仓库、截图或共享日志。本文档仅展示占位符，不需要输入真实密钥。网页应用应通过自己的服务端转发请求，避免将密钥暴露给访客。

轮换或撤销

先创建替代密钥，更新应用，验证一次请求，再撤销旧密钥。发现泄漏时应立即撤销，并检查用量日志。删除或过期后，也要更新每个客户端中的配置。

排查认证失败

确认使用的是本站密钥，去掉多余空格，并保留 Bearer 前缀。随后在控制台检查有效期、密钥限制、账户状态和余额。