API Keys 管理
安全地管理您的 API 密钥，支持多 Key 负载均衡和 Key Pool
API Key 概览
API Key 是访问 Poeti 服务的凭证。我们提供两种类型的 Key：平台 API Key 用于访问 Poeti，Provider Key 用于配置底层 AI 提供商。
Platform API Key
用于访问 Poeti API 的密钥
- 格式：sk-poeti-xxxxxxxx
- 可设置权限和过期时间
- 支持 IP 白名单限制
Provider Key
AI 提供商的原始密钥
- 支持 9 大 AI 提供商
- AES-256 加密存储
- 支持 Key Pool 负载均衡
Platform API Key 管理
创建 API Key
在控制台中创建新的 API Key，设置名称、权限和过期时间。
创建步骤
-
1登录控制台
访问 Dashboard
-
2进入 API Keys 页面
点击导航栏"API Keys"
-
3点击"创建 API Key"
填写 Key 名称和配置
-
4复制并保存 Key
⚠️ Key 只显示一次，请妥善保存
安全提示
API Key 创建后只显示一次，无法再次查看。请立即复制并妥善保存。
Key 配置选项
基本信息
- • Key 名称（便于识别）
- • Key 描述（可选）
- • 标签/分组（可选）
权限控制
- • 读写权限
- • API 端点限制
- • 速率限制
安全设置
- • IP 白名单
- • 过期时间
- • 自动轮换
监控告警
- • 使用量告警
- • 异常访问检测
- • 即将过期提醒
Key Pool 功能
Key Pool 允许您为同一提供商添加多个 API Key，系统会自动进行负载均衡和故障转移，提升可用性和吞吐量。
负载均衡
自动在多个 Key 之间分配请求，避免单 Key 速率限制
故障转移
当某个 Key 失败时，自动切换到其他可用 Key
提升吞吐
多 Key 并行使用，突破单 Key 速率限制
POST /v1/providers/openai/keys
{
"api_key": "sk-openai-xxxxx",
"name": "OpenAI Key #1",
"weight": 1,
"enabled": true
}
# 添加多个 Key
POST /v1/providers/openai/keys
{
"api_key": "sk-openai-yyyyy",
"name": "OpenAI Key #2",
"weight": 2,
"enabled": true
}Provider Keys 管理
为不同的 AI 提供商配置 API Key，支持 OpenAI、Anthropic、Google、AWS Bedrock 等。
OpenAI
GPT-4, GPT-3.5 Turbo
sk-xxxxx
Anthropic
Claude 3 Opus, Sonnet
sk-ant-xxxxx
Gemini Pro, Gemini Ultra
AIzaSyxxxxx
安全最佳实践
妥善保管 API Key
不要在代码中硬编码，使用环境变量或密钥管理服务
定期轮换 Key
建议每 90 天更换一次 API Key，降低安全风险
启用 IP 白名单
限制 API Key 只能从特定 IP 地址访问
监控 Key 使用情况
定期检查 API 调用日志，及时发现异常
及时删除unused Key
不再使用的 Key 应立即删除，避免安全隐患
API 参考
列出所有 API Keys
{
"keys": [
{
"id": "key_xxx",
"name": "Production Key",
"created_at": "2026-03-01T10:00:00Z",
"last_used_at": "2026-03-25T09:30:00Z",
"enabled": true
}
]
}创建 API Key
{
"name": "My API Key",
"permissions": ["read", "write"],
"expires_in_days": 90
}删除 API Key
{
"success": true,
"message": "Key deleted successfully"
}