本服务支持的协议

OSW 接受三种上游协议,并在同一个端口上识别它们。

协议端点典型客户端
OpenAI Chat Completions/v1/chat/completions绝大多数 OpenAI 兼容工具
OpenAI Responses/v1/responsesCodex 等
Anthropic Messages/v1/messagesClaude Code 等

路径怎么认

同一个端口同时服务这三种协议,路径带不带 /v1 前缀都识别:

http://127.0.0.1:9300/v1/chat/completions
http://127.0.0.1:9300/chat/completions

Base URL 怎么填

你的客户端Base URL
OpenAI 兼容http://127.0.0.1:9300/v1
Anthropichttp://127.0.0.1:9300

Anthropic 不加 /v1

Anthropic 客户端会自己在地址后追加 /v1/messages。加 /v1 会变成 /v1/v1/messages,代理不认识,返回 404。

GET /v1/models

由本地提供,返回你配置的模型名称(也就是逻辑模型),绝不转发上游。所以 curl http://127.0.0.1:9300/v1/models 既能验证服务在跑,也能看到当前可写的模型名。

传输形态

形态行为
非流式原样处理,读完整包再回。
流式SSE 逐帧透传。开始下发后中断即中止,不拼接。
WebSocket按连接处理。

协议转换

默认不转换:请求按它进来的协议原样转发。只有某个渠道显式开启转换后,它才可能接住其他协议的请求:

  • 原生请求优先:请求的协议与渠道支持的协议一致时,直接用原生渠道。
  • 转换请求仅在没有原生候选时使用。
  • 转换是兼容层,部分参数可能丢失,不能指望与原生完全等价。

转换开启一次只作用于这个协议端点

转换开关在供应商模型编辑弹窗的协议端点行上(见供应商与模型)。


协议没问题了,去客户端配置把工具接上。