快速入门：集成无审查 API

前提条件与 SDK 安装

API 需要有效的 API 密钥和现代 SDK。通过 pip 或 npm 为您首选的语言安装库。我们支持标准的 OpenAI 客户端库，它们自动处理身份验证和 JSON 解析。

请确保已安装 Python 3.8+ 或 Node.js 18+。SDK 会为您管理连接池和重试逻辑。这显著减少了样板代码。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ablatedmodels.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)

配置基础 URL 和 API 密钥

将您的客户端指向我们的特定端点。使用仪表板中提供的基础 URL。在 Authorization 头中传递您的 API 密钥。这确保请求直接到达 uncensored 基础设施。

不要使用默认的 OpenAI 基础 URL。如果路由错误，你的密钥将失效。在发送任何数据之前，在 SDK 配置对象中设置基础 URL。

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

发送您的第一个聊天补全请求

向 /v1/chat/completions 发送 POST 请求。包含你的模型 ID 和 messages 数组。模型立即以文本内容响应。无需复杂的路由逻辑。

保持负载简单。从单个系统提示和一个用户消息开始。验证响应结构是否符合 OpenAI 标准。这确认你的集成工作正常。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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 通过服务器发送的事件返回数据块。每个数据块包含部分文本或令牌使用数据。聚合这些数据块以显示实时输出。

支持用于函数调用的工具使用。在请求中定义您的工具。在适当时，模型会返回工具调用而非纯文本。解析工具调用以执行自定义逻辑。

Copystream = 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)

理解 Token 限制与上下文窗口

上下文窗口支持总计 100,000 个 token。这包括输入和输出 token。设置 max_tokens 以限制响应长度。如果未指定，默认最大输出为 2,048 个 token。

在最后一个流式数据块中监控令牌用量。错误不消耗信用额。这允许安全地进行实验，而无需承担财务风险。规划您的提示结构以保持在限制范围内。

排查常见错误

首先检查您的 API 密钥。401 错误表示密钥无效或已过期。402 错误表示您的预付费信用额度已耗尽。通过加密货币充值以继续。

429 错误表示速率限制。您的限制为每分钟 300 次请求。降低并发数或等待后再重试。超过 8 MB 的请求体限制也会触发 400 错误。