原生协议与接入
使用模型原生协议，配置地址和密钥即可接入
按所选模型使用对应的原生协议：OpenAI Responses、Chat Completions、Anthropic Messages 或 Gemini GenerateContent。在相应 SDK 或客户端中配置 Base URL、API Key 和模型 ID，再完成第一次调用。
使用模型对应的 SDK，简单接入
在支持所选模型原生协议的 SDK 或客户端中，配置接入地址和 API Key。
- 使用模型对应的 SDK 或客户端，并且可以设置 Base URL 与 API Key。
- 应用需要从同一当前目录中选择模型与服务档位。
- 团队能在生产使用前核对目标协议、一次真实请求和对应使用记录。
按模型选择原生协议
每个模型使用对应的原生协议。Base URL 和请求路径应同时匹配所选模型与客户端或 SDK。
responses
OpenAI Responses
- Base URL
- https://router-api.xiu.ai/v1
- 请求路径
- /responses
通过 Codex、OpenAI SDK 或基于 Responses 的应用，调用原生支持该协议的模型。
适合无状态模型请求。存储会话、后台模式、联网检索和文件检索仍需使用支持这些能力的原生服务。
messages
Anthropic Messages
- Base URL
- https://router-api.xiu.ai
- 请求路径
- /v1/messages
适合 Claude Code、Anthropic SDK 和会按 Messages 语义发送请求的 Claude 原生客户端。
适合 Messages 模型请求。托管服务端工具、Message Batches 和 Files 仍由 Anthropic 平台提供。
chat
OpenAI Chat Completions
- Base URL
- https://router-api.xiu.ai/v1
- 请求路径
- /chat/completions
适合调用原生支持 Chat Completions 的模型，可使用 OpenAI SDK、相应客户端或自定义模型入口。
工具调用、流式输出和客户端专有 Agent 能力取决于客户端与所选模型，请用目标任务单独确认。
gemini
Gemini GenerateContent
- Base URL
- https://router-api.xiu.ai
- 请求路径
- /v1beta/models/YOUR_MODEL_ID:generateContent
适合 Gemini SDK 和需要 Gemini 原生 GenerateContent 请求形状的客户端。
模型 ID 位于请求路径中，Base URL 和 OpenAI SDK 的写法不同；应按当前文档配置，不要机械套用 /v1。
用三步选对路径
选择模型及其原生协议，配置对应客户端，再验证一条请求。
- 1
确认模型原生协议
根据模型使用的 Responses、Chat Completions、Anthropic Messages 或 Gemini GenerateContent，选择支持该协议的客户端。
- 2
确认模型与服务档位
从当前模型与价格页读取精确模型 ID、声明的端点类型、档位和单价。
- 3
验证一条真实请求
创建范围明确的 Key，发送一条小请求，再在使用记录中核对模型、档位、Token、状态和结算。