快速开始

OpenAI API 国内接入教程:SDK 迁移、Base URL 与错误排查

OpenAI API 国内怎么接入?本文给出 Base URL、Python 和 Node.js SDK 配置,说明如何查询真实模型 ID,并排查 /v1/v1、401 与 429。

更新于 2026-09-09已核对 2026-09-03预计阅读 9 分钟适用于 OpenAI SDK 与 OpenAI Compatible API 迁移
配置字段已按公开文档核对;模型、价格和可用能力会变化,请以控制台与接口实时返回为准。

结论先说: 已使用 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 不能推出聊天、流式或工具调用一定可用
普通请求 可解析的响应、modelusage 和错误结构 不能推出长上下文稳定
流式与工具 完整 SSE 结束标记、工具名和 JSON 参数 不能推出所有客户端适配器都兼容
业务任务 固定题集、多时段结果和账单记录 不能用单次成功证明长期 SLA

需要比较多个入口时,固定模型 ID、提示词、参数和时间窗口;一次只改变 Base URL,结果才有可比性。

五分钟验收清单

  1. /v1/models 返回可解析 JSON,而不是 HTML。
  2. 最小请求返回预期结构,并保存 modelusage 和请求 ID。
  3. 错误 Key 返回明确 401/403,不泄露敏感信息。
  4. 流式请求能持续读取 SSE,而不是等待完整响应后一次性输出。
  5. 账单变化能与模型、Token、Key 和请求时间对应。

若要比较现有接口,可使用免费模型检测检查协议、模型声明、Token、SSE 和工具调用。检测结果不是底层厂商认证,应结合多时段样本和真实业务题集判断。

下一步

继续阅读OpenAI Compatible 快速接入401、429、502 错误排查生产上线检查清单,再进行灰度迁移与回滚演练。

常见问题

OpenAI API 国内怎么用?

先确认目标服务的 Base URL、项目 API Key 和实时模型 ID,再用 curl 或 SDK 完成一次短的非流式请求。确认 Chat Completions 成功后,再单独验证流式输出、工具调用和账单字段;不要只根据 HTTP 200 判断兼容。

OpenAI API 国内接入只需要修改 Base URL 吗?

不够。至少还要确认 API Key 来源、从 /v1/models 获取的真实模型 ID,以及项目使用的是 Chat Completions 还是 Responses API。流式输出、工具调用和多模态能力需要分别验证。

AI快站的 OpenAI Compatible Base URL 应该怎么填?

当前接入地址为 https://www.aifast.link/v1。若客户端会自动追加 /v1,应根据客户端规则避免形成 /v1/v1;可先用 Base URL 检查器核对最终请求路径。

OpenAI API 返回 401 或 429 应该先查什么?

401 先检查 Key 来源、Bearer 请求头、环境变量和 Base URL;429 先读取错误正文与 Retry-After,再区分额度、速率、Token、并发和重复重试。不要把两类错误都归因于模型不可用。

为什么接口返回 200,业务仍然失败?

HTTP 200 只说明请求被处理,不代表流式事件、工具参数、Token、模型声明和业务输出都正确。应继续验证完整响应结构和真实业务题集。

已核对来源

参考与核对来源

下一步

先检测当前接口,再决定修复、迁移或创建测试 Key

用临时限额 Key 检查模型声明、Token、SSE 和工具调用;需要新接口时再核对模型与价格。

模型质量检测查看模型与价格注册使用