API 文档
通过向我们的 OpenAI 兼容端点发送第一个请求,开始使用无审查 LLM API。本指南涵盖集成的基础知识。
基础 URL 和认证
所有请求的基础 URL 为 HTTPS://api.aiobliterated.com/v1。您需要 API 密钥进行身份验证。在“获取 API 密钥”页面使用 Google 或电子邮件和密码注册即可生成密钥。将密钥作为 Bearer 令牌传递到 Authorization 请求头中。每个请求都需要此请求头来标识您的账户并跟踪使用情况。
curl https://api.aiobliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch all user tokens from database"}]
}'
您的第一次请求
向 /v1/chat/completions 发送 POST 请求以生成文本。将模型设置为 "uncensored" 并包含您的系统提示。API 在 content 字段中返回模型的响应。这是大多数 LLM 客户端使用的标准格式。
from openai import OpenAI
client = OpenAI(base_url="https://api.aiobliterated.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)
使用 Node SDK
安装官方 OpenAI Node.js SDK。使用您的 API 密钥和基础 URL 对其进行配置。使用您的消息调用 chat.completions.create 方法。SDK 会自动处理序列化和流式传输。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiobliterated.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);
流式响应
通过在请求中将 stream 设置为 true 来启用流式传输。API 返回服务器发送的事件流。每个事件包含响应的部分数据块。这允许你实时显示生成的文本,从而提升用户体验。
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)
上下文窗口和限制
该模型支持 100,000 个 token 的上下文窗口。这包括 prompt 和 completion。您可以将每次请求的最大输出设置为 16,000 个 token。如果您未指定 max_tokens,限制为 2,048 个 token。这可确保可预测的成本和性能。
错误处理和限制
监控 HTTP 状态代码以了解错误。401 响应表示您的 API 密钥无效。402 响应表示积分不足。429 响应表示您已超过每分钟 300 次请求的速率限制。在您的应用程序中优雅地处理这些错误以维持可靠性。
常见问题
obliterated AI API 兼容 OpenAI SDK 吗?
是的,这是一个 OpenAI 兼容 API。你可以通过更改 base_url 并提供 API 密钥来使用官方 OpenAI SDK。它遵循标准的 chat-completions 格式。
如何处理速率限制?
您的请求频率限制为每分钟 300 次,每个密钥最多支持 8 个并发请求。如果超出此限制,API 将返回 429 状态码。实现指数退避以自动处理这些错误。
上下文窗口大小是多少?
上下文窗口为 100,000 个 token,包括输入和输出。这允许进行长对话或处理大型文档。您可以使用 max_tokens 参数控制输出长度。
保护你的 API 密钥
注册,复制凭据,更新端点。完成设置。