5 步使用 OpenAI 兼容 API
使用 OpenAI 风格的 API 需要五个步骤:获取密钥、安装 SDK、指向正确的 base URL、指定模型并发送消息。以下是每个步骤的代码,你可以直接粘贴。

要点
- 一旦你将 Base URL 更改为 https://api.uncensoredaiapis.com/v1 并使用你自己的密钥,任何 OpenAI SDK 都可以在此使用。
- 模型 ID 为 uncensored;主要路由是 POST /v1/chat/completions 和 GET /v1/models。
- 流式输出、JSON 模式和函数调用使用与官方 API 相同的参数。
- 价格为每 1M 输入 token $0.15,每 1M 输出 token $0.50,你可以从 $0.50 的试用额度开始。
简短说明
如果你想了解如何使用非 OpenAI 服务进行 OpenAI API 调用,答案是请求格式是一种共享约定。支持该格式的客户端需要三个值:发送请求的位置(Base URL)、你的身份(密钥)以及要运行的模型。更改这三个值,相同的代码即可工作。本站点遵循该约定,因此标准的 OpenAI Python 和 Node 包以及普通的 curl 都可以与之配合使用。
明确其含义和限制。兼容意味着接口匹配。这不代表它是官方的 OpenAI 服务,也不代表它运行 OpenAI 模型。后端是一个开放权重模型,由独立提供商运行,针对合法成人用途进行调优,使其在回答时不进行内容审查,你通过模型 ID uncensored 选择它。它仅处理文本:不支持图像、音频、嵌入或微调。
以下五个步骤大约需要十分钟。如果你更喜欢阅读多种语言的完整代码片段,请参阅 代码示例页面。
步骤 1:获取密钥
使用 Google 或电子邮件和密码注册,并打开 API 密钥页面。新用户可以一键领取 $0.50 的试用额度。有效期 7 天,每人限领一次,无需绑定银行卡。复制密钥并将其存储为环境变量,而不是将其粘贴到代码中:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"试用密钥限制为 2 个并发请求和每分钟 60 个请求。充值后的密钥允许 8 个并发和每分钟 300 个请求。试用包含的详情见 免费试用常见问题。
步骤 2:安装 SDK 并发送第一个请求
安装你所用语言的官方包。这两个库与你用于任何 OpenAI 风格服务的库相同:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai现在进行 Python 首次调用。与默认设置唯一的区别是 base_url 参数:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Node 中的相同调用:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);步骤 3:理解 messages 数组
聊天模型在调用之间不会记住任何内容。每个请求携带整个对话作为消息列表,每条消息都有一个 role。
system设置行为和风格。在此处放置人格、格式规则和约束。user包含用户提出的问题。assistant包含模型的先前回复。在继续对话时,你需要手动添加这些。tool携带函数调用的结果,下文将介绍。
要继续聊天,请将助手的回复和下一个用户消息追加到同一列表中并再次发送。这就是为什么长对话成本更高:每次调用都为完整历史记录作为输入 token 付费。上下文窗口总共容纳 100,000 个 token(提示词和补全一起),因此修剪旧轮次是构建聊天应用的正常部分。
有用的采样字段会透传:temperature、top_p、stop、seed 以及频率和存在惩罚。max_tokens 是可选的。当你希望限制回复长度和花费时设置它。
步骤 4:流式输出、JSON 模式和工具
流式输出
添加 stream: true 以接收服务器发送的 token。它使界面感觉更快,因为文本在模型仍在编写时出现,并且使用情况在流结束时报告。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}JSON 模式
当你的代码解析回复时,使用 response_format: {"type": "json_object"}。在提示词中描述所需的键。
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'函数调用
传递包含函数模式的 tools 列表,以及可选的 tool_choice。当模型希望运行函数时,回复包含 tool_calls。你在自己的代码中运行函数,并将输出作为 role 为 tool 的消息发送回去。函数调用也支持流式输出。这是代理的构建块;用例页面 展示了其优势所在。
步骤 5:了解限制、成本和错误
超过限制时,API 返回 HTTP 429。错误代码为 rate_limited(每分钟请求过多)和 concurrency(同时请求过多)。临时过载也会返回 429,并带有 Retry-After: 5 标头。流式请求在流结束前保持其并发槽位,因此请关闭你不再读取的流。正文限制为 8 MB。每个响应都带有 X-Request-Id 和 X-Balance-USD 标头,第一个是你向支持人员引用的内容。
成本很简单。一次包含 3,000 个输入 token 和 700 个输出 token 的聊天调用成本为 3,000 乘以每百万 $0.15,即 $0.00045,加上 700 乘以每百万 $0.50,即 $0.00035,总计 $0.0008。一千次此类调用成本为 $0.80。失败或被拒绝的请求不收费,且额度永不过期。定价页面 列出了从 $20 到 $500 的充值,从 $50 起 +5%,从 $100 起 +10%,从 $200 起 +15%。你可以通过加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。
与官方 API 的区别
有三点值得规划。第一,模型名称:使用 uncensored,而不是 OpenAI 的模型名称。第二,功能范围:你只能使用聊天补全和模型列表,因此图像生成、语音、嵌入和微调等功能不可用。第三,行为:该模型经过调整,不会拒绝合法的成人请求,因此输出可能与经过严格过滤的助手不同。有一条规则始终不变:没有涉及未成年人的性内容。
一些习惯在第一天会有所帮助。将密钥保存在环境变量中,记录每次调用的 X-Request-Id,并在实验时设置 max_tokens,以防止失控的回复花费超过你计划的金额。当你构建聊天界面时,流式传输回复,并在历史记录增长时修剪旧轮次。当你构建解析输出的管道时,使用 JSON 模式并仍然保护解析,因为在 token 限制处截断的回复不是有效的 JSON。当你的程序的两个部分同时调用 API 时,将它们计入付费密钥允许的 8 个并发请求中。
不要忘记测试的成本。几十次使用短提示词的实验总成本远低于一美分,因此 $0.50 的试用额度在学习请求格式时非常有用。
如果你正在迁移现有应用,迁移指南 按顺序介绍了更改。发送到此处的提示词不用于训练。对于大多数应用,迁移只需从本页面开头获取的三个值和一个模型名称。
更多指南
问答
需要使用官方 OpenAI SDK 吗?
你可以使用它,这是最简单的方案。任何 OpenAI 兼容客户端或普通 HTTP 也可以,只要支持自定义 Base URL。
我应该发送什么模型名称?
发送 uncensored。Base URL 是 https://api.uncensoredaiapis.com/v1
这是官方的 OpenAI API 吗?
不是。它遵循相同的请求格式,但模型是由独立提供商运行的开放权重模型,服务与 OpenAI 分开。
一次请求的成本是多少?
输入 token 每 100 万 token 成本为 $0.15,输出 token 每 100 万 token 成本为 $0.50。一次包含 3,000 个输入 token 和 700 个输出 token 的请求成本约为 $0.0008。
我可以在付费前试用吗?
可以。注册后,你可以一键领取 $0.50 的试用额度。有效期 7 天,无需绑定银行卡。