OpenAI 兼容 API：三行代码切换客户端

前置条件：安装 OpenAI SDK

在发起请求之前，请确保你的开发环境已安装官方 OpenAI SDK。这是开发者与 openai compatible api 交互的标准方式，可确保一致的类型定义和错误处理。对于 Python，使用 pip install openai。对于 Node.js，运行 npm install openai。这些库处理底层 HTTP 细节，让你专注于传递提示词并接收文本输出。

配置基础 URL 和 API 密钥

我们服务的核心优势在于你只需更新两个配置值。将客户端指向我们的基础 URL：https://api.openaicompatibleapi.com/v1。然后在注册页面生成 API 密钥；注册后立即显示，无需信用卡。在客户端初始化中设置 base_url 和 api_key。这使我们成为现有项目的直接 gpt api 替代方案，无需重写逻辑。

发起首次请求

使用模型 ID uncensored 发送标准的聊天完成请求。该模型是一个开放权重大型语言模型，针对合法成人用途，在回答时不会因内容审查而拒绝。它不是 GPT、Claude 或其他厂商的模型。你可以使用简单的文本提示词立即测试连通性。响应将在 content 字段中返回生成的文本。

Copycurl https://api.openaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

启用流式响应

为了获得更好的用户体验，启用流式输出以接收生成的 token。在请求中设置 stream=True。SDK 将在收到时产生数据块，允许您即时显示部分结果。这对于长达 100,000 token 的长上下文窗口特别有用。流式输出与标准 OpenAI 客户端工作方式相同，保持与您现有错误处理逻辑的兼容性。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

使用工具调用（函数调用）

我们的 API 支持结构化的函数调用。在 tools 参数中定义你的函数，模型将在响应中返回函数调用。然后你可以执行这些工具并将结果发送回模型进行进一步推理。此功能适用于任何支持标准函数调用格式的 OpenAI 兼容客户端。它非常适合构建代理或自动化工作流，而无需管理复杂的 LLM 代理。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openaicompatibleapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

查看可用模型

查询 GET /v1/models 接口以验证可用模型。你将看到 uncensored 模型列出。这确认你的 API 密钥和基础 URL 配置正确。你也可以使用此接口调试身份验证问题。如果接口返回列表，说明你与开发者 AI API 的连接已激活。不提供其他模型，保持配置简单。

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openaicompatibleapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);