无审查 ollama API 参考

基础 URL 和认证

所有请求的基础 URL 为 HTTPS://api.uncensoredollama.com/v1。您通过将 API 密钥传递到 Authorization 请求头进行身份验证。请求头格式必须为 'Bearer YOUR_API_KEY'。该密钥在您通过 Google 或电子邮件注册后立即生成。无需电话号码验证。您的密钥可与任何标准 OpenAI SDK 客户端配合使用。

首次请求

向 /v1/chat/completions 端点发送第一个提示。模型 ID 为 'uncensored'。该模型针对合法成人用途不进行内容审查。它不是 GPT 或 Claude。使用以下 curl 命令验证连通性。

Copycurl https://api.uncensoredollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 3 common rust compile errors"}]
  }'

预计返回包含生成文本的 JSON 响应。如果收到错误，请检查您的 key 有效性。该模型能很好地处理复杂指令。您可以调整 temperature 等参数以获得更具创造性的输出。

Python SDK 集成

使用官方 OpenAI Python 库以实现轻松集成。在客户端实例上设置 base_url 和 api_key 属性。这使您能够重用现有的代码结构。以下示例演示了一个简单的聊天补全调用。

Copyfrom openai import OpenAI

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

响应对象在 choices 数组中包含生成的文本。您可以直接提取内容。此方法对于批处理非常可靠。它会自动处理重试。

Node SDK 用法

使用您的凭据初始化 OpenAI 客户端。base_url 必须指向我们的端点。这确保了与标准 Node.js 应用程序的兼容性。使用以下代码片段创建客户端实例。

Copyimport OpenAI from "openai";

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

调用 chat.completions.create 方法并传入您的模型 ID。'uncensored' 模型能有效响应系统提示。您可以流式传输结果或等待完整响应。错误处理应捕获网络问题。

流式传输与使用数据

通过将 stream 设置为 true 来启用流式传输。这返回生成时的数据块。最后一个数据块包含使用情况统计信息。这包括输入和输出令牌计数。此数据对于计费准确性至关重要。

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 使用仅在最后一个数据块中提供。

限制和错误

每个密钥每分钟限 300 次请求。上下文窗口为 100,000 个 token。错误包括无效密钥的 401 和余额不足的 402。429 错误表示速率限制。在应用中优雅地处理这些代码。拒绝不消耗额度。错误免费。您的预充值额度永不过期。