结论先说: 已使用 OpenAI SDK 的项目,通常可以通过替换 Base URL、API Key 和模型 ID 迁移到 AI快站。迁移前先确认项目使用的是 Chat Completions 还是 Responses API;“兼容 OpenAI”不代表所有端点和高级参数都完全一致。
如果你搜索的是“OpenAI API 国内怎么用”,最短路径是:先在目标平台创建独立 Key,向目标 Base URL 请求 /models 获取当前账号可见的真实模型 ID,再用同一组 Key 和模型发送一条短的非流式请求。基础请求成功后,继续单独验证 SSE、工具调用、错误码和用量字段;不要把第三方网关的成功响应当成所有 OpenAI 端点都兼容。
迁移前先找出三个配置
| 项目配置 | AI快站建议值 |
|---|---|
| Base URL | https://www.aifast.link/v1 |
| API Key | 控制台创建的项目独立 Key |
| Model | /v1/models 返回的真实 ID |
建议先在测试环境迁移,不要直接替换生产配置。为不同项目创建独立 Key,设置可控额度,发生泄露或停止使用时可以单独撤销。
第一步:确认模型与基础链路
export AIFAST_API_KEY="你的_API_Key"
curl --fail-with-body --silent --show-error \
https://www.aifast.link/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
成功返回包含 data 数组的模型列表响应,说明域名、HTTPS 和 Bearer 认证链路基本正常。随后从响应中复制真实模型 ID:
export MODEL_ID="从模型列表复制的真实_ID"
第二步:迁移 Python 项目
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=os.environ["MODEL_ID"],
messages=[
{"role": "system", "content": "回答必须简洁。"},
{"role": "user", "content": "列出 API 迁移前的三项检查。"},
],
)
print(response.choices[0].message.content)
如果原项目使用 OPENAI_API_KEY,不要同时保留多个来源不明的 Key。明确环境变量优先级,避免程序读取到 OpenAI 官方 Key,而请求却发送到第三方 Base URL,或反过来。
第三步:迁移 Node.js 项目
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: process.env.MODEL_ID,
messages: [
{ role: "user", content: "只回复 OPENAI_COMPATIBLE_READY" },
],
temperature: 0,
});
console.log(response.choices[0].message.content);
先完成非流式短请求,再增加流式、工具调用、图像输入或结构化输出。一次加入过多参数,会让错误来源难以定位。
Chat Completions 与 Responses 怎么选
| 项目现状 | 建议验证路径 |
|---|---|
已使用 chat.completions.create |
先验证 /v1/chat/completions,迁移成本最低 |
| 已使用 Responses API | 先核对目标模型和入口是否支持 /v1/responses |
| 使用工具调用 | 单独验证工具名、参数 JSON 与多轮回传 |
| 使用图像、音频或文件 | 按具体端点逐项验收,不根据文本接口成功推断 |
查看大模型 API 兼容性矩阵可以快速确认需要验证的端点边界。
迁移后如何确认真的兼容?
把验收拆成四层,能避免“能返回 200”却在生产任务中失败:
| 验收层 | 最小证据 | 不能直接推出的结论 |
|---|---|---|
| 认证与目录 | /v1/models 状态码、真实模型 ID、请求 ID |
不能推出聊天、流式或工具调用一定可用 |
| 普通请求 | 可解析的响应、model、usage 和错误结构 |
不能推出长上下文稳定 |
| 流式与工具 | 完整 SSE 结束标记、工具名和 JSON 参数 | 不能推出所有客户端适配器都兼容 |
| 业务任务 | 固定题集、多时段结果和账单记录 | 不能用单次成功证明长期 SLA |
需要比较多个入口时,固定模型 ID、提示词、参数和时间窗口;一次只改变 Base URL,结果才有可比性。
五分钟验收清单
/v1/models返回可解析 JSON,而不是 HTML。- 最小请求返回预期结构,并保存
model、usage和请求 ID。 - 错误 Key 返回明确 401/403,不泄露敏感信息。
- 流式请求能持续读取 SSE,而不是等待完整响应后一次性输出。
- 账单变化能与模型、Token、Key 和请求时间对应。
若要比较现有接口,可使用免费模型检测检查协议、模型声明、Token、SSE 和工具调用。检测结果不是底层厂商认证,应结合多时段样本和真实业务题集判断。
下一步
继续阅读OpenAI Compatible 快速接入、401、429、502 错误排查和生产上线检查清单,再进行灰度迁移与回滚演练。