无审查 API 快速入门指南

认证和基础 URL

首先将您的 SDK 指向我们的基础 URL，并在授权标头中传递您的密钥。我们提供直接、单模型服务，无需代理路由费用。使用标准 Authorization: Bearer 认证方案。您的密钥在通过 Google 或邮箱注册后立即生成。确保将客户端配置中的占位符密钥替换为仪表盘上显示的密钥。基础 URL 为 https://api.uncensoredmodelsollama.com/v1. 此端点支持标准的 OpenAI 兼容客户端，允许您在不重写应用逻辑的情况下切换提供商。保持 key 安全，因为它授予访问您预付费额度余额的权限。

聊天完成端点

向 /v1/chat/completions 用于生成响应的端点。此端点处理标准的对话历史和系统提示。您必须将模型 ID 指定为 uncensored 在请求体中。API 返回包含生成文本和令牌使用统计信息的 JSON 格式响应。信用不足或密钥无效等错误将返回适当的 HTTP 状态码。使用此端点进行所有标准的文本生成任务。它不支持嵌入、图像或微调。将有效载荷保持在 8 MB 以下以确保可靠处理。模型在共享上下文窗口内处理输入和输出令牌。

流式响应

通过将 stream 在请求中设置为 true。API 返回包含文本增量块的服务器发送事件 (SSE)。这种方法减少了用户等待长输出时的感知延迟。您在流的最后一个数据块中接收令牌用量信息。在客户端实现流处理器以高效处理这些事件。流式传输非常适合聊天界面和实时应用。确保您的客户端库支持 SSE 解析，以正确处理持续的数据流。无论是否启用流式传输，总上下文窗口仍为 100,000 个令牌。

函数调用与 JSON 模式

使用 tools 用于启用函数调用功能。在请求体中定义您的函数，以允许模型返回结构化数据。设置 response_format 到 {"type": "json_object"} 以确保严格的 JSON 输出。此功能有助于提取数据或生成结构化负载。该模型支持工具选择参数来控制函数调用行为。使用这些功能将 API 集成到自动化工作流中。确保您的函数定义与预期的输入模式匹配，以获得可靠的结果。API 以标准 OpenAI 格式返回工具调用，便于解析。

参数和速率限制

使用以下参数调整生成行为： temperature, top_p，以及 seed. 设置 max_tokens 限制输出长度，如果未指定则默认为 2,048。API 对每个密钥实施每分钟 300 次请求的速率限制。每个密钥的并发请求上限为 8 次。如果超出这些限制，API 将返回 429 状态码。请求根据实际令牌使用量收费，错误和拒绝免费。信用额度永不过期，预付款项透明。仔细管理您的密钥，因为每个账户一次仅支持一个活动密钥。

限制、错误和上下文

上下文窗口支持 100,000 个 token，用于合并的输入和输出。请求体超过 8 MB 的请求将失败。常见错误包括：无效密钥导致 401，余额不足导致 402。请在您的应用逻辑中优雅地处理这些错误。API 会拒绝包含涉及未成年人性内容的请求，无论其他设置如何。其他内容对合法成人用途保持 uncensored。监控您的 token 使用情况以避免意外费用。预付费信用系统确保您只为实际使用的部分付费。您的集成无需订阅费或隐藏费用。

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

流式传输

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)