快速入门：几分钟内完成集成

1. 安装您的 SDK

首先为您的语言安装官方库。大多数开发人员更喜欢标准包，因为它与他们已经熟悉的接口匹配。运行 pip install openai for Python 或 npm install openai for Node.js。您只需要一个 SDK 来处理所有请求。

2. 设置您的 base URL

配置你的客户端指向我们的特定端点。你必须覆盖默认基础 URL 以正确路由流量。使用 https://api.unsencoredai.com/v1 作为您的基础 URL。在 Authorization 头部。此设置兼容任何标准 OpenAI 兼容客户端。

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unsencoredai.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);

3. 发送第一个请求

发送标准聊天补全请求以生成文本。模型 ID 为 uncensored. 您可以发送系统提示以引导模型行为。API 将返回直接的文本响应。使用下面的 curl 命令立即测试连通性。检查您的响应是否包含 choices 数组。

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. 处理流式响应

启用流式传输以降低延迟并实现实时输出。设置 stream: true 在你的请求中。API 通过服务器发送事件发送数据块。你可以随到达处理每个 token。这非常适合聊天界面或角色扮演场景。最后一个数据块包含使用统计信息。

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)

5. 配置参数

调整 temperature, top_p，以及 stop 序列。这些控制影响创造力和输出长度。您还可以使用 response_format for JSON 模式。上下文窗口总共支持 100,000 个令牌。每次请求的最大输出为 16,000 个令牌。根据您的特定用例微调这些设置。

6. 限制、错误和上下文

使用标准 HTTP 状态码优雅地处理错误。401 错误表示您的 API 密钥无效。402 错误表示预付费信用额度不足。429 错误表示您达到了每分钟 300 次请求的限制。您的上下文窗口为 100,000 个令牌。超过 8 MB 的请求可能会失败。不退还信用额度，但错误是免费的。