指南
身份验证
了解如何通过 TokiAI 对您的 API 请求进行身份验证。
API 密钥身份验证
所有模型 API 请求均需使用 API 密钥进行身份验证。请在 Authorization 请求头中包含您的密钥，格式与 OpenAI API 一致：
Authorization: Bearer YOUR_API_KEY创建 API 密钥
您可以在 TokiAI 控制台 中创建和管理 API 密钥：
- 登录后进入 API 密钥 页面。
- 点击 创建密钥。
- 设置密钥名称、供应商、额度和有效期。
- 复制生成的密钥并妥善保管。
API 密钥可能只在创建时完整展示。请立即复制，并使用环境变量或密钥管理器安全存储。
密钥最佳实践
| 实践 | 说明 |
|---|---|
| 使用环境变量 | 切勿在源代码中硬编码密钥 |
| 定期轮换 | 每 90 天轮换一次密钥 |
| 使用独立密钥 | 为不同环境创建独立密钥 |
| 监控用量 | 在控制台中追踪 Token 余额和密钥使用情况 |
OpenAI SDK 认证
使用官方 OpenAI SDK 时，请将您的 API 密钥设置为 TokiAI Router 的密钥，并将基础 URL（baseURL）配置为指向 TokiAI 的 API 端点。
import OpenAI from 'openai';
const openai = new OpenAI({
baseURL: 'https://www.tokiai.ai/v1',
apiKey: process.env.TOKI_API_KEY,
});常见认证错误
| 情况 | 处理方式 |
|---|---|
未提供 Authorization | 检查请求头是否包含 Bearer 前缀。 |
| API Key 无效或已停用 | 在控制台确认密钥状态，必要时重新创建。 |
| 密钥过期 | 修改有效期或创建新的 API Key。 |
| 额度不足 | 检查账号 Token 余额和密钥额度限制。 |