协议与兼容性
每个配置 API 可选择开放一种或多种 Lumoswitch Runtime 统一下游格式。请求直达Lumoswitch 推理服务,并统一使用 Lumoswitch Access Key 鉴权。
| 格式 | 方法 | 路径 |
|---|---|---|
| OpenAI | GET | /v1/models |
| OpenAI | POST | /v1/chat/completions、/v1/responses、/v1/embeddings |
| Anthropic | POST | /v1/messages、/v1/messages/count_tokens |
| Gemini | POST | /v1beta/models/{model}:generateContent、:streamGenerateContent、:countTokens |
| Gemini | POST | /models/{model}:generateContent、:streamGenerateContent、:countTokens |
OpenAI 客户端使用 https://api.lumoswitch.com/v1,Anthropic 与 Gemini 客户端使用 https://api.lumoswitch.com。故障转移中的全部候选必须支持客户端实际使用的能力。
在客户端对应的原生鉴权 Header 中填写 Lumoswitch Access Key:OpenAI 使用 Authorization: Bearer,Anthropic 使用 x-api-key,Gemini 使用 x-goog-api-key。下游客户端不得填写上游渠道 Key。
这些路径是 Lumoswitch Runtime 的统一协议转换入口:Anthropic 或 Gemini 格式的客户端可以调用任意兼容的已配置上游。/anthropic/*、/gemini/*、/cohere/* 等渠道原生透传路径仍保持私有,因为它们不遵循配置 API 的模型与凭据边界。