什么是原厂协议 Bypass 接口

原厂协议 Bypass 接口是一组保留模型厂商原生请求和响应格式的接入方式。调用方可以继续使用 Anthropic Messages、Gemini GenerateContent 或 OpenAI Responses 的字段结构，不需要先把请求转换成统一的 OpenAI Chat Completions 格式。

这里的“Bypass”是指绕过统一协议转换，并不表示请求绕过 Modelink。请求仍会经过 Modelink 的 API Key 鉴权、模型权限检查、限流、渠道路由、用量统计和计费等网关处理。

信息

原厂协议 Bypass 接口会尽量保留厂商协议的字段和响应事件，但它不是直接访问模型厂商的网络地址。Modelink 仍可能根据模型别名、上游渠道和网关能力对模型名称、认证信息或少量扩展字段进行处理。

与兼容协议的区别

对比项	兼容协议	原厂协议 Bypass 接口
请求格式	使用统一的 OpenAI 或 Anthropic 兼容格式	使用对应模型厂商的原生协议格式
响应格式	由兼容接口返回统一或兼容后的响应结构	尽量保留厂商原生响应结构和流式事件
适用场景	多模型统一接入、通用对话、已有兼容客户端迁移	使用原生工具调用、思考、缓存、联网搜索等厂商特有能力
Modelink 能力	鉴权、权限、限流、路由、用量统计和计费	同样保留鉴权、权限、限流、路由、用量统计和计费

Anthropic 两个 Messages 接口的区别

POST /bypass/anthropic/v1/messages 和 POST /v1/messages 都接收 Anthropic Messages 格式，但两者在 Modelink 内部的处理方式不同。

对比项	`/bypass/anthropic/v1/messages`	`/v1/messages`
接口定位	Anthropic 原厂协议 Bypass 接口	Anthropic Messages 兼容接口
模型范围	仅接受 Claude 模型	以 Messages 兼容方式调用平台支持的模型
请求处理	不经过统一协议转换，保留原厂 Messages 请求结构	解析 Messages 请求，并根据选中的上游渠道进行协议适配
上游请求	直接按照原厂 Messages API 格式发送，例如 Claude Messages API	完成协议适配后，再发送给实际选中的上游接口
适合场景	依赖 Claude 原厂字段、流式事件或其他原生能力	希望使用统一入口和 Modelink 的多渠道兼容能力

信息

如果需要尽量保持 Claude 原厂 Messages API 的请求和响应语义，请使用 /bypass/anthropic/v1/messages；如果需要由 Modelink 根据实际渠道完成协议适配，请使用 /v1/messages。

当前提供的 Bypass 接口

模型厂商	接口路径	协议格式	支持的模型
Anthropic	`POST /bypass/anthropic/v1/messages`	Anthropic Messages API	支持所有 Claude 模型
Google	`POST /bypass/vertex/v1/models/{model}:{func}`	Gemini GenerateContent	支持所有 Gemini 模型
OpenAI	`POST /bypass/openai/v1/responses`	OpenAI Responses API	支持所有 GPT 模型

具体的请求参数、鉴权请求头和响应结构，请继续查看本栏下方的接口列表。

什么时候使用

如果业务需要统一切换不同厂商的模型，优先使用兼容协议。如果业务依赖某个厂商原生协议中的专有字段、流式事件或扩展能力，则使用对应的 Bypass 接口。

迁移现有厂商 SDK 时，通常可以保留原有请求体和响应解析逻辑，将 Base URL 与 API Key 替换为 Modelink 的接入信息，再根据接口文档验证所用字段。