OpenAI Compatible API 的价值，在于让现有 SDK、脚本和工具通过统一协议连接不同模型。迁移时通常不需要重写业务逻辑，重点是确认 Base URL、API Key、模型 ID 和接口类型。
直接答案
接入 OpenAI Compatible API 时，先把 Base URL 配置为服务商文档给出的地址，再用同一个 API Key 请求 /v1/models，复制返回的真实模型 ID，最后发送一条 stream: false 的短请求。若最终地址出现 /v1/v1、返回 HTML 或模型列表中的 ID 不可用，先修复 Base URL、认证或模型权限，再继续测试 SSE 和工具调用。
OpenAI Compatible API 怎么接入和测试？
最短路径是四步：确认 Base URL、用同一个 Key 请求 /v1/models、复制响应中的真实 data[].id，再发送一条短的非流式请求。只有基础请求和模型权限都确认后，才继续验证 SSE、工具调用、Responses 或生产流量。
| 先核对什么 | 可复查的证据 | 通过后再做什么 |
|---|---|---|
| Base URL | 最终请求地址只包含一层 /v1 |
请求 /v1/models |
| API Key | Authorization: Bearer 来自同一平台 |
复制返回的真实模型 ID |
| 模型 ID | data[].id 与当前账号可见模型一致 |
发送短的 stream: false 请求 |
| 协议能力 | 状态码、响应 model、usage 和结束状态 |
单独测试 SSE、工具调用和 Responses |
这张表只定义验收顺序，不代表任何平台的模型或高级能力都必然兼容。
OpenAI Compatible API 的 Base URL 应该怎么填？
OpenAI SDK 会在 Base URL 后追加模型列表和聊天端点。常见版本路径是 /v1，完整示例为 https://www.aifast.link/v1。如果客户端明确说明会自行追加版本路径，则只填写域名。判断标准不是配置框的名称，而是诊断日志中的最终请求地址。如果地址出现 /v1/v1，说明版本路径被重复拼接；返回网页首页也不是有效 API 响应。
先预览最终路径，再请求 /v1/models 并发送最小非流式请求。只有这两步通过，才继续验证 SSE、工具调用和重试。
OpenAI Compatible API 怎么测试？
最短验收路径是：先请求 /v1/models，再用返回的真实模型 ID 发一条短的非流式请求。两步都成功后，再分别验证 SSE、工具调用和用量字段；这样可以把 URL、认证、模型权限和高级协议问题分开定位。
如果你需要检查 OpenAI Compatible API 的 URL，可以先使用Base URL 检查器；如果需要判断网关的协议与行为信号，再运行模型质量检测。检测结果是当前时点的兼容性抽样，不是厂商身份认证或长期 SLA。
开始前检查
准备以下三项：
- 在 AI快站控制台创建的 API Key。
- 接口基础地址
https://www.aifast.link/v1。 - 控制台模型广场中显示的真实模型 ID。
API Key 只会在创建时完整显示。不要把它写入公开仓库、前端代码、截图或聊天记录。
配置步骤
1. 先查询模型列表
在终端执行：
curl https://www.aifast.link/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"如果成功返回包含 data 数组的模型列表响应，说明域名解析、HTTPS 和身份验证链路基本正常。如果返回 401，先检查 Key；如果返回 HTML 页面，通常是 Base URL 写错或请求没有进入 API 路由。
2. 使用 Python SDK
安装 SDK：
python -m pip install --upgrade openai把 Key 放进环境变量：
export AIFAST_API_KEY="你的_API_Key"最小调用示例：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIFAST_API_KEY"],
base_url="https://www.aifast.link/v1",
)
response = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[
{"role": "user", "content": "用三句话解释什么是提示缓存。"}
],
)
print(response.choices[0].message.content)将 YOUR_MODEL_ID 替换为模型广场中的真实模型 ID，不要填写卡片标题、中文别名或厂商名称。
3. 使用 Node.js SDK
npm install openai
export AIFAST_API_KEY="你的_API_Key"import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.AIFAST_API_KEY,
baseURL: "https://www.aifast.link/v1",
});
const response = await client.chat.completions.create({
model: "YOUR_MODEL_ID",
messages: [
{ role: "user", content: "列出 API 上线前需要检查的五项配置。" },
],
});
console.log(response.choices[0].message.content);4. 不要重复拼接 /v1
不同客户端对 Base URL 的处理方式不同：
| 客户端字段 | 建议填写 |
|---|---|
| 明确要求 Base URL | https://www.aifast.link/v1 |
客户端会自动追加 /v1 |
https://www.aifast.link |
| 完整请求地址 | 按客户端要求填写到具体接口 |
如果日志里出现 /v1/v1/chat/completions，说明客户端和配置各追加了一次 /v1。
常见问题
返回 401 Unauthorized
- Key 前后是否多了空格或引号。
- 是否误用了已删除、过期或属于其他账号的 Key。
- 请求头是否为
Authorization: Bearer YOUR_KEY。
返回 model not found
- 先调用
/v1/models获取真实模型 ID。 - 不要把网页展示名称当作接口模型名。
- 确认模型是否对当前账号开放。
流式输出中断
先关闭流式模式做一次短请求。如果非流式请求正常，再检查客户端读取超时、代理缓冲和网络连接，而不是直接更换模型。
下一步
第一次请求成功后，再逐步加入流式输出、重试、超时、日志和模型路由。不要在尚未验证基础调用时一次性接入所有高级参数。
查看 401、429、502 API 错误排查，或前往 AI快站模型广场 确认当前可用模型。
需要核对 AI快站当前域名、Base URL 或平台运营声明时，请回到平台事实、官方入口与验证边界查看证据类型和最后验证日期。