面向开发者的 OpenAI 替代方案:密钥和 SDK 设置
即插即用的无审查 OpenAI API 替代方案
面向开发者的 OpenAI 替代方案最多只需一下午,而不是需要重写代码。它与标准 OpenAI SDK 兼容:你只需更改基础 URL,粘贴新密钥,然后调用名为 uncensored 的模型。

要点
- 注册,在 API 密钥页面领取 $0.50 试用额度,并复制密钥。试用无需绑定银行卡。
- 在任何 OpenAI SDK 中将 base_url 设置为 https://api.openaiapialternative.com/v1,将 model 设置为 uncensored。
- 流式输出、工具调用和 JSON 模式遵循 OpenAI 格式。限制为 8 个并发请求和每分钟 300 个请求(全量套餐密钥)。
- 处理 HTTP 429 错误时,使用短暂退避并尊重 Retry-After 标头。
从零到成功调用的五个步骤
如果你想今天就能测试一个面向开发者的 OpenAI 替代方案,这就是完整路径。大约需要十分钟。
- 使用 Google 账号或邮箱密码创建账户。
- 打开 API 密钥页面,点击领取试用额度的按钮。你将获得 $0.50,有效期 7 天,每人限领一次,无需绑定银行卡。
- 复制密钥。将其视为密码,不要将其提交到 git。
- 在 SDK 或客户端中将 Base URL 设置为
https://api.openaiapialternative.com/v1。 - 发送请求,将模型设置为
uncensored。
其余所有内容(包括消息格式、流式输出和工具调用)与你已使用的 OpenAI chat completions 格式相同。服务提供 POST /v1/chat/completions 和 GET /v1/models。没有更多功能,因此学习成本很低。
Python 官方 SDK
使用 pip install openai 安装包。客户端将 Base URL 和密钥作为构造函数参数,因此不会修改全局状态,你可以在同一进程中为另一个提供商保留第二个客户端。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.openaiapialternative.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "Answer briefly and directly."},
{"role": "user", "content": "List three edge cases for a date parser."},
],
max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)max_tokens 是可选的。如果未设置,补全结果可能会使用 100,000 token 窗口中剩余的所有空间,因此在需要可预测成本时应设置上限。
聊天模型自身没有记忆。每个请求都必须携带你希望模型看到的历史记录,因此多轮对话中的助手角色只是你不断追加的消息列表:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
history = [{"role": "system", "content": "You are a patient pair-programming partner."}]
while True:
user = input("you> ")
if not user:
break
history.append({"role": "user", "content": user})
r = client.chat.completions.create(model="uncensored", messages=history)
answer = r.choices[0].message.content
history.append({"role": "assistant", "content": answer})
print(answer)输入 token 随着每一轮对话增加,因为每次都会发送整个列表。虽然 100,000-token 窗口提供了大量空间,但每次调用都要为历史记录付费,因此在列表变长时,请删除旧轮次或对其进行摘要。
Node 和 curl
Node SDK 遵循相同的模式。使用 npm install openai 安装,并传入 baseURL。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.openaiapialternative.com/v1",
apiKey: process.env.UNCENSORED_API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about stack traces." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}要从终端快速检查,列出模型。你应该看到一个 ID 为 uncensored 的条目。
# expect one entry with id "uncensored"
curl https://api.openaiapialternative.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_API_KEY"流式请求会占用一个并发槽位,直到流结束。如果客户端在关闭连接前放弃流,这会有影响。当用户离开页面时,请在您的侧关闭连接。
编辑器、代理和其他客户端
许多开发者工具允许你覆盖 OpenAI 基础 URL。Cursor 等编辑器有模型设置界面,你可以在其中输入自定义的 OpenAI 兼容基础 URL 和密钥,SillyTavern 等聊天前端允许你添加自定义 OpenAI 兼容接口。标签和菜单位置在不同版本间会有变化,请寻找名为“覆盖 OpenAI 基础 URL”或“自定义接口”的字段。
无论使用什么工具,您都需要相同的三个值:
| 字段 | 说明 |
|---|---|
| Base URL | https://api.openaiapialternative.com/v1 |
| API 密钥 | 你账户中的密钥 |
| 模型名称 | uncensored |
如果工具坚持要求已知模型名称列表,请将 uncensored 添加为自定义模型。如果它自动附加 /v1,请提供不带后缀的地址,否则你会得到重复的路径和未找到错误。
工具调用和 JSON 模式
结构化输出通常是替代 API 出错的地方,因此请尽早测试。这两个功能都使用 OpenAI 格式。对于 JSON 模式,设置 response_format 并在提示词中提及 JSON。
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": "Reply with a JSON object with keys title and tags."},
{"role": "user", "content": "Describe a short story about a lost lighthouse keeper."},
],
)
data = json.loads(resp.choices[0].message.content)
print(data["title"], data["tags"])对于工具,传递包含函数模式的 tools 列表,从回复中读取 tool_calls,自行运行函数,并将结果作为带有 role: "tool" 的消息发送回来。流式响应会分段交付 tool_calls,因此在解析之前请累积参数字符串。
无论使用哪个提供商,模型偶尔仍可能返回格式错误的 JSON。将解析包装在 try 块中,并在错误消息附加到对话后重试一次。
种子也会一并传入,因此设置 seed 并配合固定的 temperature 值,可以让您比较相同输入下提示词的变化。不要期望每次运行都输出完全相同的字节,但差异会大幅缩小。
限制、429 处理和成本控制
完整 API 密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个和 60 个。请求体最多 8 MB。每个响应都包含 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency,以及 X-Balance-USD 显示您的剩余额度。
超出限制会返回 HTTP 429。错误代码会告知是哪个限制:rate_limited 表示每分钟请求过多,concurrency 表示同时请求过多。临时过载也会返回 429,并带有 Retry-After: 5 响应头。OpenAI SDK 默认使用退避策略重试 429 响应,您可以在客户端使用 max_retries 增加重试次数。对于批处理任务,使用 8 个信号量可确保不超过并发上限。
进行预算规划时,请参考价格:输入 token 每 1M 个 $0.15,输出 token 每 1M 个 $0.50。发送 4M 输入 token 并获取 1M 输出 token 的任务成本为 4 x $0.15 + 1 x $0.50 = $1.10。失败或被拒绝的请求不收费。定价页面 列出了充值金额和奖励。
如果你没有使用自动重试的 SDK,一个简短的重试包装器就足够了。如果存在 Retry-After 头,请读取它;否则使用指数退避延迟;尝试几次后放弃。不要对非 429 错误或非服务器故障进行重试,因为格式错误的请求每次都会以相同的方式失败。
第一天可能导致浪费一小时的常见错误
大多数首次调用失败都来自少数几个原因。在怀疑服务之前,请检查这些内容。
- 路径重复。 Base URL 已经以
/v1结尾。不要添加另一个,也不要不带它调用/chat/completions。 - 模型名称错误。 旧代码通常包含供应商的模型名称。将其替换为
uncensored,否则调用将无法匹配任何内容。 - 密钥包含空白字符。 从网页或终端复制的密钥通常包含尾随换行符。请去除它。
- 在生产并发下测试试用密钥。 该试用密钥允许 2 个并发请求和每分钟 60 个请求,因此 20 线程的负载测试会几乎立即返回带有代码
concurrency的 429。 - 期望其他接口。 图像、音频和嵌入调用不属于服务。
第二类是行为而非配置。没有拒绝行为的模型会比预期更字面地遵循奇怪的指令。如果回答偏离了你想要的方向,请收紧系统提示词,而不是调整 temperature。如果输出重复,请稍微提高 temperature 或添加频率惩罚,两者都会透传。
值得尽早养成的最后一个习惯:存储每次让你感到惊讶的调用的确切请求体。当你在 支持页面 向团队寻求帮助时,请求 ID 加上该请求体就是完整的错误报告。
发布前须知
- 将密钥保留在服务器上。不要将其包含在浏览器包或移动应用中。
- 每次调用时记录
X-Request-Id响应头。这使支持问题变得可回答。 - 如果最终用户可以自由输入,请添加自己的输入和输出过滤。模型不会拒绝,因此审核由你定义。
- 在配置中保留备用提供商。切换只需更改 Base URL,因此功能标志就足够了。
- 记住范围:仅限文本,无嵌入,无图像,无微调。
文档 包含完整的参数列表。如果某些行为异常,支持页面 会告诉你如何联系团队。
更多指南
问答
哪些 SDK 可用?
任何支持设置 Base URL 和 API 密钥的 OpenAI SDK 或客户端均可使用。官方 Python 和 Node.js 库可用,使用 curl 发起普通 HTTP 请求也可用。
试用需要银行卡吗?
不需要。注册后在 API 密钥页面点击一次即可领取 $0.50 试用额度,无需绑定银行卡。该额度有效期为 7 天,每人限领一次。
模型名称是什么?
模型 ID 为 uncensored。调用 GET /v1/models 可通过你自己的密钥进行确认。
请求的大小限制是多少?
上下文窗口为 100,000 token(含提示词和补全),最大请求体为 8 MB。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。