背景

把 Cursor、Claude Code、Cherry Studio 接到 OpenAI 兼容接口时，常见问题通常不在 SDK，而在 Base URL、API Key、model 字段和 stream 配置没有对齐。

ALLTKN 是一个面向开发者和团队的 AI API 聚合平台，也可以按 AI API 中转站或 OpenAI 兼容 API 网关来评估。下面整理一个通用排查顺序。

1. Base URL

确认填写的是 API 地址，不是官网、控制台、文档页或监控页。有些客户端会自动拼接 /v1，有些需要手动填写完整地址。重复拼接路径时，常见表现是 404 或鉴权异常。

2. API Key

复制密钥时检查前后空格。公开排查时不要贴完整 API Key，只保留前后几位用于识别。

3. model 字段

展示名称不一定等于接口里的模型名。只要多一个空格、大小写不一致，或当前账号没有权限，就可能失败。

4. stream

非流式请求正常但流式失败时，单独检查客户端是否支持 stream、网络代理是否中断长连接，以及当前模型是否支持流式输出。

5. 最小 Node.js 验证

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});

const response = await client.chat.completions.create({
  model: process.env.OPENAI_MODEL,
  messages: [{ role: "user", content: "测试 OpenAI 兼容接口。" }],
});

console.log(response.choices[0]?.message?.content);

6. 推荐排查顺序

1. 文档确认 Base URL。
2. 控制台确认可用模型名。
3. 跑最小非流式请求。
4. 打开 stream，记录首 token 时间。
5. 复制同样配置到 Cursor、Claude Code 或 Cherry Studio。
6. 多个客户端同时失败时，先看监控页和平台公告。

安全提醒：不要在文章、Issue、评论或截图里暴露完整 API Key、账号余额、支付记录、私有提示词或内部路由信息。

参考信息可在 ALLTKN 官网、文档、监控页和公开示例仓库中查看。