Lumoswitch
协议与兼容性

协议与兼容性

协议决定下游客户端如何向 Lumoswitch 发送请求，以及 Lumoswitch 如何解释上游响应。协议名称相同不代表所有厂商专有字段都完全一致。

当前公开 Gateway API

当前公开 API 参考保证以下 OpenAI-compatible 路由：

GET  /v1/models
POST /v1/chat/completions
POST /v1/responses
POST /v1/embeddings

配置 API 中选择的输出协议必须与客户端使用的接口一致。不要把 Anthropic 或 Gemini 的原生请求直接发送到 OpenAI-compatible 路径。

协议选择

客户端类型推荐选择说明
OpenAI SDK、Aider、OpenCode、OpenWebUIOpenAI-compatible使用 /v1 Base URL
CodexOpenAI-compatible / Responseswire_api = "responses"
Claude Code以控制台当前生成配置为准不同版本对自定义提供方支持不同
自研客户端OpenAI-compatible优先从最小 Chat 请求开始验证

OpenAI-compatible 的边界

通常可复用常见请求结构，但以下内容应单独验证：

  • Streaming 事件格式与结束标记。
  • Tool Call 和工具结果消息。
  • Reasoning 字段。
  • JSON Schema 或结构化输出。
  • 多模态输入。
  • 厂商专有采样参数。
  • previous_response_id 等 Responses 状态行为。

Anthropic 与 Gemini 选项

控制台可能提供 Anthropic 或 Gemini 输出选项。只有当当前实例提供对应下游路由，并且控制台生成了明确的 Base URL 与客户端配置时才应使用。若没有对应的公开端点说明，请使用 OpenAI-compatible 输出。

验证顺序

  1. 用 Access Key 调用 /v1/models。
  2. 发起非流式最小文本请求。
  3. 验证流式输出。
  4. 再验证 Tools、Vision、Reasoning 或结构化输出。
  5. 最后接入会自动添加额外参数的客户端。
OpenWebUI本地模型接入