认证指南

所有 UloveGPT API 请求都需要通过 API Key 进行认证。本指南介绍如何获取和管理你的 API Key。

获取 API Key

  1. 前往 www.ulovegpt.com/dashboard 登录或注册账号
  2. 在左侧导航栏选择 API Keys
  3. 点击 创建新 Key,输入名称(便于识别用途)
  4. 复制并安全保存你的 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 都有独立的用量统计

认证错误

状态码原因解决方法
401API Key 无效检查 Key 是否正确复制
401API Key 已过期创建新的 API Key
403账户余额不足充值后继续使用
403IP 被限制在控制台配置允许的 IP 白名单