API 参考 — OpenAI / Anthropic / Gemini 三协议 | ClaudeYY Docs

来源: https://www.claudeyy.com/zh/docs/api
说明: ClaudeYY API 参考总览，支持 OpenAI、Anthropic、Gemini 三大协议，统一认证接入 100+ 大模型，含端点、错误码和协议选择建议

API 概览

ClaudeYY 提供三种协议的 API 接入方式，完全兼容各厂商官方 SDK，包括 OpenAI 最新的 Responses API。

协议推荐： OpenAI 协议推荐使用 Responses API，原生 Prompt Caching 支持更优；调用 Claude 模型推荐使用 Anthropic 原生协议，可获得完整特性和原生缓存优势。

Base URL

协议	Base URL	说明
OpenAI 兼容	`https://claude.claudeyy.com/v1`	兼容 OpenAI SDK，支持 Chat Completions 和 Responses API
Anthropic 原生	`https://claude.claudeyy.com/anthropic`	兼容 Anthropic SDK，原生 Claude 体验
Gemini 原生	`https://claude.claudeyy.com/gemini`	兼容 Google GenAI SDK

认证

所有协议使用统一的 ClaudeYY API Key，但 Header 格式因协议而异：

协议	Header	格式
OpenAI	`Authorization`	`Bearer sk-xxx`
Anthropic	`x-api-key`	`sk-xxx`
Gemini	`x-goog-api-key`	`sk-xxx`

详见认证指南。

可用端点

OpenAI 兼容协议

端点	方法	说明
`/v1/chat/completions`	POST	创建对话补全
`/v1/responses`	POST	创建模型响应（Responses API，推荐）
`/v1/embeddings`	POST	创建文本向量
`/v1/images/generations`	POST	图像生成
`/v1/models`	GET	列出所有可用模型
`/v1/models/{provider}`	GET	按供应商过滤模型
`/v1/models/{provider}/{model_id}`	GET	获取模型详情
`/v1/models/count`	GET	获取模型数量统计

Anthropic 原生协议

端点	方法	说明
`/anthropic/v1/messages`	POST	创建 Messages（推荐）
`/anthropic/v1/models`	GET	列出所有可用模型
`/anthropic/v1/models/{provider}`	GET	按供应商过滤模型
`/anthropic/v1/models/{provider}/{model_id}`	GET	获取模型详情
`/anthropic/v1/models/count`	GET	获取模型数量统计

Gemini 原生协议

端点	方法	说明
`/gemini/v1beta/models/{model}:generateContent`	POST	生成内容
`/gemini/v1beta/models/{model}:streamGenerateContent`	POST	流式生成内容
`/gemini/v1beta/models`	GET	列出所有可用模型
`/gemini/v1beta/models/{provider}`	GET	按供应商过滤模型
`/gemini/v1beta/models/{provider}/{model_id}`	GET	获取模型详情
`/gemini/v1beta/models/count`	GET	获取模型数量统计

速率限制

ClaudeYY 按量付费，所有用户共享统一的速率策略，无套餐差异：

限制项	额度
RPM（请求/分钟）	200
TPM（Token/分钟）	不限

如需更高速率配额，请联系 ClaudeYY 支持申请调整。

当触发限流时，API 返回 429 Too Many Requests，响应 Header 包含：

Terminal

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

错误码

所有协议返回统一的 HTTP 状态码：

状态码	说明	常见原因
`200`	成功	—
`400`	请求错误	参数格式错误、缺少必填字段
`401`	认证失败	API Key 无效或过期
`403`	权限不足	账户无权访问该模型
`404`	资源不存在	模型 ID 错误
`429`	触发限流	超过速率限制
`500`	服务器错误	内部错误，请重试
`502`	上游错误	模型供应商服务异常
`503`	服务不可用	服务维护中

错误响应格式

Terminal

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

ClaudeYY 扩展参数

ClaudeYY 在标准协议基础上提供扩展参数，用于高级路由和回退控制：

Terminal

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

详见供应商路由和故障回退。