​
通用 OpenAI 兼容配置

适用于提供“OpenAI Compatible”“OpenAI API”或自定义 OpenAI Base URL 配置项的客户端。客户端最终使用的接口通常是 GET /v1/models、POST /v1/chat/completions 或 POST /v1/responses。 具体客户端的字段名称与界面会有差异；已完成真实验证的产品会提供独立页面。

​
配置项

不要同时填写 https://your-domain/v1 并让客户端再次追加 /v1，否则会形成错误的 /v1/v1/... 路径。

​
检查模型列表

先验证 API Key 和可用模型：
OpenAI 兼容响应返回 object: "list"，模型名称位于 data[].id。只选择当前列表实际返回、且适合目标客户端协议的模型。

​
最小对话验证

如果客户端使用 Chat Completions，可先确认同一组配置可以完成最小文本请求：
成功时从 choices[0].message.content 读取文本。完整字段说明见 OpenAI Chat Completions。

​
常见问题

​
模型列表为空

  1. 检查 Base URL 是否重复包含 /v1。
  2. 检查 API Key 是否正确，以及该 Key 是否有可见模型。
  3. 客户端不支持模型发现时，使用平台可见模型名称手工填写。

​
返回 401 或 403

  1. 确认请求头使用 Authorization: Bearer YOUR_API_KEY。
  2. 删除 API Key 前后的空格或换行。
  3. 不要混用 Anthropic 的 x-api-key 或 Gemini 的 x-goog-api-key 请求头。

​
Agent 能回复但工具无法执行

纯文本 Chat Completions 成功不等于 Agent 工具链已验证。工具调用、文件访问、MCP、联网与客户端本地命令执行需要按具体产品和版本单独验证；未出现在独立“已验证”页面的产品不应视为完整支持。