Unlimited AI API: 快速入门 指南
获取你的 API 密钥,几分钟内即可开始发送文本请求。本指南涵盖基础 URL、身份验证以及我们无审查 LLM 的标准 OpenAI 兼容接口。
基础 URL 与身份验证
我们的 API 完全兼容 OpenAI SDK 格式。你必须将 base URL 设置为 https://api.unlimitedaiapi.com/v1。这确保所有请求都路由到我们的专用无审查模型,而不是代理或聚合器。认证使用 Authorization 头中的 Bearer token。你只需使用邮箱和密码注册后,即可立即生成密钥。密钥在注册后显示一次,但你随时可以重新生成它,这将使旧密钥失效。试用层级不需要手机号或信用卡。
首次请求
首先发送一个简单的聊天补全请求。这将确认你的 API 密钥有效,并让你了解响应速度。模型 ID 始终为 uncensored。你可以在单个请求中发送多条消息以维持上下文。该模型接受标准的 OpenAI 消息格式。无需管理复杂的路由规则或供应商特定的怪癖。
curl https://api.unlimitedaiapi.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."}]
}'检查包含生成文本的 choices 数组。如果收到 401 错误,请验证你的 API 密钥。402 错误表示你的预付额度已耗尽。
Python SDK 集成
使用官方的 openai Python 库可使集成变得极其简单。在客户端初始化时设置 base_url 和 api_key。此方法适用于同步调用,这是大多数脚本的标准模式。我们支持标准的文本输入和输出。我们不提供嵌入或图像生成,因此请保持负载专注于文本。SDK 自动处理分词,因此基本用法无需手动计算 token。
from openai import OpenAI
client = OpenAI(base_url="https://api.unlimitedaiapi.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)确保使用支持 base_url 参数的最新 SDK 版本。此设置直接连接至我们的基础设施,无需第三方路由层。
Node SDK 用法
对于 Node.js 环境,官方的 openai 包只需最少配置即可使用。在初始化时传入 API 密钥和正确的基础 URL。这允许你利用现有的 Node.js 基础设施,同时完全控制 API 调用。我们支持标准的请求-响应模式。流式输出通过服务器发送事件(SSE)单独处理。该模型是开放权重模型,经过调整以减少拒绝,适合法律范围内的创意或争议性话题。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unlimitedaiapi.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);请记住我们按 token 收费,因此请通过响应头或仪表板监控使用情况。没有隐藏费用或月度订阅。
流式响应
你可以通过将 stream 参数设置为 true 来启用流式输出。API 返回服务器发送事件(SSE)而非单个 JSON 对象。这降低了长输出的感知延迟。每个块包含响应的部分增量。你必须累积这些增量以重建完整文本。计费仍基于处理的总输入和输出 token,无论是否流式输出。这对于希望随生成显示文本的 UI 非常理想。
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)小心处理 SSE 解析,以避免连接意外断开时的内存泄漏。100,000 token 上下文窗口适用于整个对话历史,而不仅仅是当前轮次。
限制、错误与上下文
你的 API 密钥限制为每分钟 300 个请求。如果超出此限制,你将收到 429 速率限制错误。最大请求体大小为 8 MB。该模型具有 100,000 token 上下文窗口,结合提示词和补全 token。这足以满足大多数长文档任务。我们不提供微调或模型路由。如果需要嵌入,必须使用单独的服务。硬性内容限制阻止涉及未成年人的色情内容,但允许合法的成人和争议性话题。401 错误表示密钥无效,402 表示预付额度不足。
API 技术参数
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| Base URL | https://api.unlimitedaiapi.com/v1 |
| 认证 | Authorization: Bearer YOUR_KEY |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 并发 | 每个密钥同时最多 8 个请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 登录 | 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 | 模型繁忙——几秒后重试 |
问答
无审查模型是否兼容标准 OpenAI 工具?
是的,我们的 API 完全兼容 OpenAI。你可以使用标准的 chat-completions 接口,配合任何支持 <code>base_url</code> 配置的 OpenAI SDK 或客户端。我们支持通过 SSE 进行函数调用和流式输出。
流式输出的计费方式是怎样的?
计费基于处理的输入和输出 token 总数,无论使用流式输出还是标准响应。流式输出仅影响延迟,不影响每个 token 的成本。你需为每 1M 输入 token 支付 $0.25,为每 1M 输出 token 支付 $1.00。
我可以使用此 API 进行图像或音频生成吗?
不可以,我们仅通过 <code>chat-completions</code> 接口提供文本生成。我们不支持嵌入、图像、音频或视频生成。如果需要这些功能,你需要为特定步骤集成其他服务。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。