无审查 API 快速入门指南
立即开始使用 Sansursuz API:借助 OpenAI 兼容的基础设施,获取 API 密钥,只需编写几行代码即可开始文本生成。我们提供用于纯文本生成、高上下文窗口和直接访问的快速设置指南。
- Base URL
- https://api.sansursuzapi.com/v1
- 模型
- uncensored
安装和所需库
无审查 API 专为与 OpenAI SDK 和客户端直接兼容而设计。集成设置只需将代码中的 base_url 值设置为 https://api.sansursuzapi.com/v1 并配置 API 密钥。只需安装对应语言的 SDK 包即可,无需额外的服务器配置或复杂的身份验证机制。我们的系统使用标准的 Bearer token 身份验证,并将密钥直接通过请求头传递。
基本请求示例
要开始使用 API,只需发送一个简单的 POST 请求即可触发文本生成。以下示例展示了如何通过 curl 访问 uncensored 模型。请求体中指定了模型名称、用户消息和响应格式。该结构遵循 OpenAI 标准的 chat-completions 方案。
curl https://api.sansursuzapi.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."}]
}'
此请求是测试模型无审查行为的理想起点。返回的 JSON 对象包含生成的文本和 token 统计信息。您可以使用此简单结构进行快速测试,然后根据项目需求自定义参数。
流式输出和函数调用
对于大文本块或长对话历史场景,您可以使用流式(streaming)模式。此模式允许您逐块处理来自服务器的数据,从而提升用户体验。此外,还支持函数调用(function calling)功能,使模型能够与外部工具交互。此功能允许模型根据特定的 JSON 模式返回数据,并在您的应用程序中处理这些数据。
from openai import OpenAI
client = OpenAI(base_url="https://api.sansursuzapi.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)
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sansursuzapi.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);
Python 和 Node.js SDK 提供了管理这些流式和函数结构所需的工具。您可以选择性地使用 stream: true 参数分块接收响应,或使用 tools 结构配置模型的数据生成。
模型列表和兼容性
我们的 API 目前仅提供一个大语言模型:uncensored。该模型采用经过专门调整的开放权重架构,旨在消除标准模型中常见的过滤机制。你可以通过模型列表接口(GET /v1/models)验证当前模型。该模型独立于 OpenAI 的 GPT、Claude、Gemini 或 Grok 系列,运行于我们自己的 GPU 服务器上。这种兼容性允许你直接使用现有的 OpenAI 客户端。
错误代码和限制
使用 API 时可能遇到的主要状态代码包括:401 表示 API 密钥无效或缺失,402 表示信用额度不足,以及 429 表示超过每分钟 300 次请求的速率限制。每个账户仅有一个有效的 API 密钥;刷新密钥后旧密钥将失效。请求体不应超过 8 MB。上下文窗口限制为 100,000 token,这表示提示词和补全文本的 token 总数。这些限制对 API 的稳定运行至关重要。
定价和信用额度管理
无审查 API 采用按量付费(pay-as-you-go)模式。输入 token 按每 100 万 token 0.25 美元计费,输出 token 按每 100 万 token 1.00 美元计费。已支付的信用额度永久保留,无订阅费。新账户无需信用卡即可获得有效期为 7 天的 0.50 美元试用额度。信用额度耗尽时服务不会中断,只需为新的请求充值即可。充值 50 美元可获得 +5% 奖励,充值 100 美元可获得 +10% 奖励。
流式输出
stream = 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)技术规格
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| Base URL | https://api.sansursuzapi.com/v1 |
| 认证 | Authorization: Bearer YOUR_KEY |
| JSON 模式 | response_format: {"type": "json_object"} |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 登录 | Google 或邮箱 + 密码 |
错误说明
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
常见问题
我如何管理 API 密钥?如果丢失了怎么办?
您可以在账户面板中查看或刷新 API 密钥。刷新密钥后,旧密钥将立即失效,无法用于新请求。每个账户仅有一个有效密钥。
我使用的信用额度会过期吗?
不会,您充值的信用额度不会过期。信用额度耗尽时服务不会完全中断,但您需要充值才能继续生成 token。信用额度余额永久保留在您的账户中。
模型会拒绝哪些类型的内容?
对于合法的成人内容、虚构场景和安全研究,模型通常不会拒绝。但始终存在一条严格的限制:包含青少年/儿童的色情内容会被永久屏蔽。此限制独立于模型设置,在系统层面强制执行。
您的密钥长度与表单相当
创建一个账户,复制密钥并更改 base URL。设置就这么简单。