OpenAI 兼容 API 接口:支持情况
本服务支持的 OpenAI 兼容 API 接口列表,包含每个接口的有效请求及缺失功能的清晰列表。
要点
- 五个路径:聊天补全、Responses、模型及两条余额路径。
- 模型 ID 为 uncensored,一个密钥即可配合任何 OpenAI SDK 使用。
- 不支持图像、音频、视频、嵌入或微调。
- 限制返回 HTTP 429 及清晰的错误代码。

接口概览
提供商真正实现了哪些 OpenAI 风格路径?以下是该 API 的简短列表。基础 URL:https://api.uncensoredendpoint.com/v1。每次调用均需使用 Bearer 密钥进行认证。
| 方法和路径 | 用途 |
|---|---|
POST /v1/chat/completions | 聊天请求、流式输出、工具、JSON 模式 |
POST /v1/responses | 较新的 Responses 风格请求格式 |
GET /v1/models | 列出模型;ID 为 uncensored |
GET /v1/dashboard/billing/credit_grants | OpenAI 风格的余额格式 |
GET /v1/balance | 简单形式的余额 |
这就是全部功能。表中未列出的内容均未提供。继续阅读以获取有效请求列表及缺失功能列表,以便你在编写代码前进行规划。
聊天补全
这是大多数客户端使用的接口。将任何 OpenAI SDK 指向 Base URL 并使用模型名称 uncensored。
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)支持的参数包括 stream、tools、tool_choice、response_format(含 json_object),以及采样参数:temperature、top_p、stop、seed 和惩罚参数。max_tokens 是可选的,因为补全可以使用 100,000 token 上下文窗口中剩余的任何内容。
使用 stream: true 时,回复以服务器发送事件形式到达,并在末尾包含用量,以便你记录 token 计数。
多轮聊天
API 不保留对话状态。对于多轮聊天,你每次都需要发送完整的消息列表:首先是系统消息,然后是交替的用户和助手轮次。这意味着输入 token 会随着每一轮增加,成本也随之增加,因此在对话变长时,应修剪或总结旧轮次。上下文窗口为 100,000 token(包含提示词和补全),这对大多数聊天来说已经足够,但粘贴文档很容易填满它。
Responses、模型与余额
Responses
较新的 OpenAI 示例使用 /v1/responses。此处也提供该功能,因此为该格式编写的代码无需重写。
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'使用你的客户端所期望的方式。如果是从零开始,聊天补全功能拥有最广泛的功能支持。
模型与余额
列出模型以检查你的密钥是否有效。你应该看到一个条目 uncensored,因为该服务运行一个模型,并非跨供应商的路由器。
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"你还会在每个响应的 X-Balance-USD 标头中获取余额,这在应用中无需额外请求即可提供低额度警告。其他标头包括用于支持问题的 X-Request-Id,以及 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。
工具与 JSON 模式实践
两个功能将聊天接口转变为可构建产品的基础。工具调用允许模型请求你的代码运行函数。JSON 模式使其返回可解析的输出。两者都使用标准请求字段。
工具调用如下所示。模型返回一个 tool_calls 条目,你运行该函数,然后以 role: "tool" 消息形式将结果发回。
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)对于 JSON 模式,添加 response_format={"type": "json_object"} 并在提示词中说明你想要 JSON,最好包含你期望的键。始终在 try 块内解析:没有任何模型保证每次调用都符合你的架构,因此在信任结果前请验证。
迁移现有的 OpenAI 项目
如果你的应用已使用 OpenAI SDK,迁移只需三次编辑且无需新库。大多数 SDK 读取相同的两个环境变量,因此你通常无需更改任何代码。
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);然后在代码中搜索模型名称(如 GPT 模型 ID)并将其替换为 uncensored,因为该服务只有一个模型。移除对嵌入、图像或音频的调用,并将这些调用路由到其他提供商。保留简短清单:基础 URL 已更改、模型名称已更改、密钥存储在环境变量中而非仓库中、429 重试逻辑、基于余额标头的低余额警报。有关密钥设置,请参阅 如何获取 uncensored AI API 密钥。然后运行单个测试请求并检查是否返回 X-Balance-USD,然后再切换真实流量。
未提供的功能
了解这些缺失功能可节省一天的调试时间。该 API 仅支持文本。以下 OpenAI 接口不可用:
- 图像和视觉生成。 无图像生成或编辑。
- 音频。 无语音转文本或文本转语音。
- 视频。 未提供。
- 嵌入。 如果你构建检索系统,你需要单独的嵌入服务。
- 微调。 你无法在服务上进行训练。
调用这些路径会失败,因此请避免在共享客户端配置中包含它们。典型设置是将此 API 用于聊天,并将另一个提供商用于嵌入,你的应用根据任务选择 Base URL。
限制、错误和重试
完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发和每分钟 60 个请求。最大请求体为 8 MB。当你超过限制时,会收到 HTTP 429 错误,错误代码会指明是哪一项:rate_limited 表示每分钟请求数,concurrency 表示同时请求过多。在临时过载时,你也会收到 429,并带有 Retry-After: 5 标头。
一个细节容易让人忽略:流式请求会占用并发槽位,直到流结束,因此读取速度慢会占用并发限制。一个简单的重试包装器可以处理所有这些情况:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")失败或被拒绝的请求不会收费,因此错误重试不会额外花费。对于批处理作业,完整密钥将工作池上限设为 8,试用密钥设为 2,而不是依赖重试。固定池更易于分析,并且可以防止一个慢速流饿死其他流。
成本和访问
定价为每 100 万输入 token $0.15,每 100 万输出 token $0.50,从预付额度扣除,无订阅,永不失效。以 $20 至 $500 之间的任意整数金额充值,支持加密货币(TRC20 上的 USDT、Base 上的 USDC)。大额充值可获额外奖励:$50 起 +5%,$100 起 +10%,$200 起 +15%。详见 定价页面。
要试用,请使用 Google 或邮箱注册,然后在 API 密钥页面上一键领取 $0.50 试用额度。文档涵盖了每个参数,接口概览解释了该服务的性质:一个用于合法成人用途的开放权重模型,无内容审查,并严格禁止涉及未成年人的色情内容。
更多指南
问答
是否支持流式输出和函数调用?
是。使用 stream: true 进行服务器发送事件流式输出并在末尾获取用量,使用带 tool_choice 的工具调用进行函数调用。
有嵌入接口吗?
没有。服务仅支持文本聊天,请使用其他提供商进行嵌入。
我如何查看余额?
调用 GET /v1/balance 或 OpenAI 风格的 credit_grants 路径,或读取任何响应中的 X-Balance-USD 头。
当我达到速率限制时会发生什么?
你将收到 HTTP 429 状态码,错误代码为 rate_limited 或 concurrency。等待并重试;在临时过载时,Retry-After 头指示等待 5 秒。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。