认证指南
所有 UloveGPT API 请求都需要通过 API Key 进行认证。本指南介绍如何获取和管理你的 API Key。
获取 API Key
- 前往 www.ulovegpt.com/dashboard 登录或注册账号
- 在左侧导航栏选择 API Keys
- 点击 创建新 Key,输入名称(便于识别用途)
- 复制并安全保存你的 API Key — 它只会显示一次
⚠️ 安全提示:API Key 是你的账户凭证,请勿在公开仓库或客户端代码中暴露。建议使用环境变量存储。
认证方式
不同协议使用不同的认证 Header:
OpenAI 兼容协议
Authorization HeaderBash
curl https://www.ulovegpt.com/v1/chat/completions \
-H "Authorization: Bearer sk-of-your-api-key"Anthropic 原生协议
x-api-key HeaderBash
curl https://www.ulovegpt.com/anthropic/v1/messages \
-H "x-api-key: sk-of-your-api-key" \
-H "anthropic-version: 2023-06-01"Gemini 原生协议
x-goog-api-key HeaderBash
curl "https://www.ulovegpt.com/gemini/v1beta/models/..." \
-H "x-goog-api-key: sk-of-your-api-key"SDK 中的认证
使用官方 SDK 时,推荐通过环境变量设置认证:
环境变量Bash
# OpenAI SDK
export OPENAI_API_KEY="sk-of-your-api-key"
export OPENAI_BASE_URL="https://www.ulovegpt.com/v1"
# Anthropic SDK
export ANTHROPIC_API_KEY="sk-of-your-api-key"
export ANTHROPIC_BASE_URL="https://www.ulovegpt.com/anthropic"管理 API Key
- 重命名:在控制台中修改 Key 的名称以便识别
- 禁用/启用:临时停用某个 Key 而不删除
- 删除:永久删除 Key,删除后无法恢复
- 用量查看:每个 Key 都有独立的用量统计
认证错误
| 状态码 | 原因 | 解决方法 |
|---|---|---|
401 | API Key 无效 | 检查 Key 是否正确复制 |
401 | API Key 已过期 | 创建新的 API Key |
403 | 账户余额不足 | 充值后继续使用 |
403 | IP 被限制 | 在控制台配置允许的 IP 白名单 |