API Documentation & Quickstart

Base URL and Authentication

To use the uncensored ai api, point your OpenAI-compatible client to our base URL: https://api.uncensoredchatbotapi.com/v1. This ensures all requests route directly to our dedicated GPU servers running the 'uncensored' model, avoiding the latency and routing complexity of aggregator services.

Authentication is handled via a Bearer token. Create an account at the Get API key page to receive your unique key. Include it in every request header. If you regenerate your key, the previous one becomes invalid immediately.

Required Header

• Authorization: Bearer YOUR_API_KEY

First Request with cURL

Verify your integration by sending a simple text generation request. This endpoint supports standard chat-completions parameters. Replace YOUR_API_KEY with your actual key.

This call demonstrates the direct text-in, text-out behavior of the uncensored api. The model will respond without content refusals for lawful adult topics, though it strictly blocks sexual content involving minors.

Copycurl https://api.uncensoredchatbotapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK Integration

Use the official OpenAI Python library for easy integration. Set the base URL to our endpoint. This approach works with any OpenAI-compatible client library.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredchatbotapi.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 SDK Integration

For JavaScript environments, use the @anthropic-ai/sdk or openai npm package. Configure the base URL and API key as shown below.

Copyimport OpenAI from "openai";

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

Streaming Responses

For real-time user experiences, enable streaming. Set stream: true in your request. The server returns Server-Sent Events (SSE) containing partial token completions.

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)

Rate Limits, Errors, and Constraints

Understand the constraints before scaling your application. The uncensored llm api enforces a limit of 300 requests per minute per API key. The maximum request body size is 8 MB.

Common Errors

• 401: Invalid or expired API key.
• 402: Insufficient prepaid credit. Top up from $10 via crypto (USDT or USDC).
• 429: Rate limit exceeded. Wait and retry.

Model Details

Use model ID uncensored. Context window is 100,000 tokens. Pricing is $0.25 per 1M input tokens and $1.00 per 1M output tokens.