接口地址

优芯中转站基础地址：

https://api.yucpu.com

不要把基础地址写成 https://docs.yucpu.com。docs.yucpu.com 只用于查看文档，真正的接口请求走 api.yucpu.com。

Claude / Anthropic 兼容

用于 Claude Code、CCSwitch、Anthropic SDK 或其他 Claude 兼容客户端。

POST https://api.yucpu.com/v1/messages

最小验证请求：

curl https://api.yucpu.com/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 128,
    "messages": [
      { "role": "user", "content": "回复 pong" }
    ]
  }'

OpenAI Chat Completions

用于 OpenAI 兼容 SDK、IDE 插件、聊天客户端。

POST https://api.yucpu.com/v1/chat/completions

最小验证请求：

curl https://api.yucpu.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      { "role": "user", "content": "回复 pong" }
    ]
  }'

OpenAI Responses / Codex

用于支持 Responses API 的 OpenAI 兼容客户端，以及 Codex 类工具。

POST https://api.yucpu.com/v1/responses

最小验证请求：

curl https://api.yucpu.com/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": "回复 pong"
  }'

Gemini 兼容

用于 Gemini API 兼容客户端。

GET  https://api.yucpu.com/v1beta/models
POST https://api.yucpu.com/v1beta/models/{model}:generateContent
POST https://api.yucpu.com/v1beta/models/{model}:streamGenerateContent?alt=sse

模型名称

模型名称以 API Hub 的 渠道状态 页面展示为准。不同分组支持的模型和倍率可能不同。

如果请求返回模型不可用，先确认：

1. API Key 所在分组是否支持该模型。
2. 渠道状态页面里该模型是否可用。
3. 模型名称是否完整，是否误用了上游别名。