路由与协议

PipeLLM 对外提供两类公共路由：

只有当你的请求体已经符合目标协议时，才应该使用原生路由。想保留现有 SDK 格式、去调用别的协议族模型时，应该使用 converter 路由。

路由矩阵

请求格式	原生路由	Converter 路由	说明
OpenAI Chat Completions	`/v1/chat/completions`	`/openai/v1/chat/completions`	原生路由用于 OpenAI 兼容平台；converter 路由用于用 OpenAI 格式调用 Anthropic 或 Gemini 模型。
OpenAI Responses	`/v1/responses`	暂未提供	目前只支持 OpenAI 兼容平台原生路由；如果今天要跨协议调用，请先改用 OpenAI Chat Completions converter。
Anthropic Messages	`/v1/messages`	`/anthropic/v1/messages`	原生路由用于 Anthropic 兼容平台；converter 路由用于用 Anthropic 格式调用 OpenAI 或 Gemini 模型。
Gemini Generate Content	`/v1beta/models/{model}:generateContent`	`/gemini/v1beta/models/{model}:generateContent`	原生路由用于 Gemini 平台；converter 路由用于用 Gemini 格式调用 OpenAI 或 Anthropic 模型。
Gemini Stream Generate Content	`/v1beta/models/{model}:streamGenerateContent`	`/gemini/v1beta/models/{model}:streamGenerateContent`	与 `generateContent` 采用同样的路由规则。

/v1/chat/completions 和 /v1/responses 只接受 OpenAI 兼容请求体，并且只会路由到 OpenAI 兼容平台。
/v1/messages 只接受 Anthropic Messages 请求体，并且只会路由到 Anthropic 兼容平台。
Gemini 原生端点只接受 Gemini 请求体，并且只会路由到 Gemini 平台。
/openai/...、/anthropic/...、/gemini/... 这类 converter 前缀路由不会被原生路由的协议 guard 拦截。

目标	应该使用的路由
保留 OpenAI SDK，调用 Claude	`https://api.pipellm.ai/openai/v1/chat/completions`
保留 OpenAI SDK，调用 Gemini	`https://api.pipellm.ai/openai/v1/chat/completions`
保留 Anthropic SDK，调用 GPT	`https://api.pipellm.ai/anthropic/v1/messages`
保留 Anthropic SDK，调用 Gemini	`https://api.pipellm.ai/anthropic/v1/messages`
保留 Gemini SDK，调用 GPT	`https://api.pipellm.ai/gemini/v1beta/models/{model}:generateContent`
保留 Gemini SDK，调用 Claude	`https://api.pipellm.ai/gemini/v1beta/models/{model}:generateContent`

协议不匹配时，错误体统一为：

{
  "error": {
    "type": "invalid_request_error",
    "code": "400",
    "message": "..."
  }
}

错误信息会明确告诉开发者：

公共路由和端点总览

保留 SDK 格式，跨协议调用模型

PipeLLM 上的 /v1/responses