常见说明

这里回答首次接入最常被问到、但不属于某一个工具的问题。遇到具体报错时仍应优先看 报错指南。

我应该选哪个接口？

你的现状	建议
使用 Chatbox、Cline、Cherry Studio、OpenAI SDK 等常见客户端	选择 OpenAI 兼容方式，Base URL 填 https://xikapi.com/v1
已有使用 messages 和 max_tokens 的 Claude 代码	使用 Anthropic Messages 兼容接口
已有 Gemini 的 contents / parts 代码	使用 Gemini Generate Content 兼容接口
不确定	从 快速开始 的 OpenAI Chat Completions 最小请求开始

不要为了使用某个模型而随意改协议。模型能力、接口协议和客户端支持是三个独立问题：先确认客户端支持哪种协议，再选择相应模型。

模型名为什么不能照抄文档？

模型是否可调用取决于控制台当前启用状态和 API Key 的权限。文档里的模型名仅用于说明格式；请在控制台复制实际模型 ID。模型名可能包含版本后缀、大小写或斜杠，复制后不要自行简化。

API Key 要怎样保存？

• 本机首次测试：只放在当前终端环境变量中。
• 桌面客户端：放入工具自己的密钥字段，不要导出或分享完整配置。
• 服务端和团队：使用部署平台的 Secret / 环境变量能力，并按环境使用不同 Key。
• 代码仓库：把 .env 放入忽略列表，只提交 .env.example，其中只保留变量名和占位值。

一旦 Key 出现在截图、聊天记录、Issue、公开仓库或日志中，应尽快在控制台撤销并重新创建，不要只修改前后几位再继续使用。

流式输出、图片和工具调用为什么失败？

基础文本请求成功，不代表所有高级能力都可用。高级能力同时受模型、接口协议、客户端版本和权限影响。请先关闭扩展参数，确认纯文本请求正常，再一次只打开一项能力并保留错误信息。

怎样提供可排查的信息？

提供这些内容通常足够定位问题：请求时间和时区、模型 ID、请求路径、HTTP 状态码、错误文本、是否流式、是否包含图片或工具调用。不要提供真实 API Key、完整请求头、私有文件内容或包含个人数据的完整提示词。