Base URL 与请求规则
Base URL 不是完整接口地址
使用 SDK 或图形化工具时，通常填写的是 Base URL，而不是某个具体接口：
text
https://xikapi.com/v1工具会自动在后面追加 /chat/completions、/responses 等路径。把完整接口地址填入 Base URL 字段，常见结果是重复路径或 404。
只有在自己使用 curl、fetch、requests 等 HTTP 客户端时，才填写完整请求地址，例如：
text
https://xikapi.com/v1/chat/completions协议与字段必须成对使用
| 请求地址 | 最小字段 | 不应该混入的字段 |
|---|---|---|
/v1/chat/completions | model、messages | input、contents |
/v1/responses | model、input | 直接沿用 Chat Completions 的 messages 结构 |
/v1/messages | model、messages、max_tokens | Gemini 的 contents |
/v1beta/models/{model}:generateContent | contents、parts | OpenAI 的 messages |
如果只是确认基础连通性，请先使用 Chat Completions。遇到 400 或 unsupported parameter 时，先移除高级参数，再确认请求字段是否属于当前协议。
请求写法的安全边界
- API Key 仅放在
Authorization: Bearer ...请求头或工具的私密字段中。 - SDK 的 Base URL 与直接请求的完整地址不要混写。
- 模型 ID 必须来自控制台，不要把供应商名或文章中的示例名当作实际 ID。
- 生产环境记录状态码、request id、模型 ID 和请求时间；不要记录完整 Key 或用户私密内容。