身份验证

Vergora API 使用 API Key 验证请求身份。所有请求都应从服务端发送，并通过 Authorization 请求头传递凭证。

请求头格式

Authorization: Bearer YOUR_VERGORA_API_KEY

Bearer 与 API Key 之间必须保留一个空格。不要把 API Key 放在 URL 查询参数中。

创建 API Key

1. 登录控制台并打开 API Keys。
2. 创建一个新的 API Key。
3. 使用能够识别应用和环境的名称，例如 storefront-production。
4. 根据应用需要设置预算、有效期和模型访问范围。
5. 按页面提示复制并安全保存完整 API Key。

配置建议

在应用中使用

export VERGORA_API_KEY="YOUR_VERGORA_API_KEY"

应用从服务端环境变量或密钥管理工具读取该值。不要把完整 Key 写入源代码、浏览器脚本、公开仓库、日志或截图。

轮换与停止使用

1. 创建替代 Key。
2. 更新应用配置并发送最小请求。
3. 在 Requests 中确认新 Key 的请求成功。
4. 停止旧 Key 的使用。
5. 检查是否还有应用继续使用旧凭证。

如果完整 Key 丢失，请按控制台提供的流程创建替代凭证。怀疑凭证泄露时，应立即停止其使用并检查相关请求记录。

鉴权失败排查

第一次接入请先完成快速开始。