API 概览

UloveGPT Gateway 提供三大原生协议，一个 API Key 即可调用 100+ 大模型。

Base URL

根据你使用的协议，选择对应的 Base URL。将官方 SDK 的 base URL 替换为以下地址即可。

协议	Base URL	说明
`OpenAI`	`https://www.ulovegpt.com/v1`	兼容 OpenAI SDK
`Anthropic`	`https://www.ulovegpt.com/anthropic`	兼容 Anthropic SDK
`Gemini`	`https://www.ulovegpt.com/gemini/v1beta`	兼容 Google GenAI SDK

认证

所有 API 请求都需要在 Header 中携带有效的 API Key。不同协议使用不同的认证方式：

OpenAI 协议Bash

curl https://www.ulovegpt.com/v1/chat/completions \
  -H "Authorization: Bearer sk-of-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5.4-mini", "messages": [{"role": "user", "content": "Hello"}]}'

Anthropic 协议Bash

curl https://www.ulovegpt.com/anthropic/v1/messages \
  -H "x-api-key: sk-of-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-sonnet-4.6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Gemini 协议Bash

curl "https://www.ulovegpt.com/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview:generateContent" \
  -H "x-goog-api-key: sk-of-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'

可用端点

OpenAI 兼容协议

端点	方法	说明
`/v1/chat/completions`	POST	聊天补全
`/v1/responses`	POST	Responses API (推荐)
`/v1/models`	GET	列出可用模型
`/v1/models/count`	GET	获取模型数量
`/v1/embeddings`	POST	向量化
`/v1/images/generations`	POST	图像生成

Anthropic 原生协议

端点	方法	说明
`/anthropic/v1/messages`	POST	消息对话
`/anthropic/v1/models`	GET	列出可用模型
`/anthropic/v1/models/count`	GET	获取模型数量

Gemini 原生协议

端点	方法	说明
`/gemini/v1beta/models/{model}:generateContent`	POST	内容生成
`/gemini/v1beta/models`	GET	列出可用模型
`/gemini/v1beta/models/count`	GET	获取模型数量

速率限制

当请求频率超出限制时，API 会返回 429 状态码，并在响应头中提供限流信息：

Rate Limit HeadersHttp

x-ratelimit-limit-requests: 200
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1s

错误码

HTTP 状态码	说明
`400`	请求参数错误
`401`	认证失败（API Key 无效或过期）
`403`	权限不足（余额不足或模型未授权）
`429`	请求频率超限
`500`	服务器内部错误
`503`	服务暂时不可用

错误响应格式：

Error ResponseJson

{
  "error": {
    "code": "invalid_api_key",
    "message": "提供的 API Key 无效，请检查后重试。",
    "type": "authentication_error"
  }
}

UloveGPT 扩展参数

UloveGPT 在标准 API 基础上提供了扩展参数，支持高级路由和故障回退功能：

Extended ParametersJson

{
  "model": "openai/gpt-5.4-mini",
  "messages": [...],
  "provider": {
    "routing": "cost",
    "fallback": ["anthropic/claude-sonnet-4.6", "google/gemini-3.1-flash-lite-preview"]
  }
}

参数	说明
`provider.routing`	路由策略：`cost`（最低成本）、`latency`（最低延迟）、`quality`（最高质量）
`provider.fallback`	故障回退模型列表，当首选模型不可用时自动切换