中文 ▾
Base URL https://api.uncensoredaiapis.com/v1模型 uncensored
获取 API 密钥
Uncensored AI迁移指南

5 步使用 OpenAI 兼容 API

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

更新于

五块发光的垫脚石通向服务器立方体,展示了开始使用 OpenAI 风格 API 的步骤

要点

  • 一旦你将 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 天,无需绑定银行卡。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。