OpenAI Compatible API 快速接入教程

OpenAI Compatible API 的价值，在于让现有 SDK、脚本和工具通过统一协议连接不同模型。迁移时通常不需要重写业务逻辑，重点是确认 Base URL、API Key、模型 ID 和接口类型。

开始前检查

准备以下三项：

在 AI快站控制台创建的 API Key。
接口基础地址 https://www.aifast.club/v1。
控制台模型广场中显示的真实模型 ID。

API Key 只会在创建时完整显示。不要把它写入公开仓库、前端代码、截图或聊天记录。

配置步骤

1. 先查询模型列表

在终端执行：

curl https://www.aifast.club/v1/models \
  -H "Authorization: Bearer $AIFAST_API_KEY"

如果返回模型数组，说明域名解析、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.club/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.club/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.club/v1`
客户端会自动追加 `/v1`	`https://www.aifast.club`
完整请求地址	按客户端要求填写到具体接口

如果日志里出现 /v1/v1/chat/completions，说明客户端和配置各追加了一次 /v1。

常见问题

返回 401 Unauthorized

Key 前后是否多了空格或引号。
是否误用了已删除、过期或属于其他账号的 Key。
请求头是否为 Authorization: Bearer YOUR_KEY。

返回 model not found

先调用 /v1/models 获取真实模型 ID。
不要把网页展示名称当作接口模型名。
确认模型是否对当前账号开放。

流式输出中断

先关闭流式模式做一次短请求。如果非流式请求正常，再检查客户端读取超时、代理缓冲和网络连接，而不是直接更换模型。

下一步

第一次请求成功后，再逐步加入流式输出、重试、超时、日志和模型路由。不要在尚未验证基础调用时一次性接入所有高级参数。

查看 401、429、502 API 错误排查，或前往 AI快站模型广场确认当前可用模型。