Documentação da API & Início Rápido

Autenticação & URL Base

Inicie cada solicitação apontando seu cliente para HTTPS://api.uncensoredia.com/v1 e anexando sua chave. Autorização usa o padrão Bearer scheme, então basta colar o token que você recebeu após o cadastro com Google ou e-mail. O endpoint é totalmente API compatível com openai conforme, o que significa que você só precisa trocar a URL base e a chave de API em sua configuração existente. Você não precisa gerenciar camadas complexas de roteamento ou cabeçalhos proxy. Apenas certifique-se de que seu Authorization cabeçalho contém seu token único. Esta configuração garante que suas solicitações cheguem ao modelo dedicado sem censura sem qualquer filtragem intermediária. Se você receber um 401 erro, verifique se sua chave está ativa e formatada corretamente.

Endpoint Chat Completions

Envie mensagens para POST /v1/chat/completions para receber respostas de texto do modelo sem censura. Este único endpoint lida com todas as suas necessidades de geração, desde prompts simples até conversas complexas de múltiplas rodadas. Você pode controlar o comprimento e a aleatoriedade da saída usando parâmetros como max_tokens, temperature, e top_p. O modelo suporta uma enorme 100.000 tokens janela de contexto, permitindo que você alimente documentação extensa ou históricos longos de conversas. Você pode enviar até 16.000 tokens na resposta. Se você omitir max_tokens, o limite padrão é 2.048 tokens. Este endpoint não suporta geração de imagens ou áudio. É estritamente texto de entrada, texto de saída. Use o seguinte comando curl para testar sua conexão imediatamente.

Integração do SDK Python

Use a biblioteca oficial da OpenAI para Python para interagir com a API com mínimas alterações de código. Você só precisa substituir o base_url e api_key na configuração do cliente. Esta abordagem garante que sua lógica existente para lidar com respostas, erros e tentativas de reconexão permaneça intacta. A biblioteca lida automaticamente com a serialização JSON e streaming se você habilitá-la. Este método é ideal para serviços backend ou scripts que precisam processar grandes volumes de texto. O modelo uncensored responde a solicitações padrão de conclusão de chat sem exigir lógica de parsing personalizada. Configure seu cliente uma vez e use-o em toda a sua aplicação. Veja como inicializar o cliente e enviar uma solicitação básica.

Configuração do SDK Node.js

Integre a API em seus aplicativos JavaScript ou TypeScript usando o @anthropic-ai/sdk ou o oficial openai pacote. Defina o baseURL para o nosso endpoint e forneça sua chave de API. Isso permite que você use métodos familiares como chat.completions.create() diretamente. O SDK lida com as solicitações HTTP e analisa as respostas JSON para você. Você pode lidar facilmente com erros como 402 (crédito insuficiente) ou 429 (limite de taxa) dentro da lógica do seu aplicativo. Essa configuração é perfeita para servidores web, bots ou qualquer ambiente Node.js. O modelo sem censura funciona perfeitamente com o formato de solicitação padrão. Configure seu cliente para garantir a compatibilidade com as expectativas da API.

Respostas em Streaming

Ativar entrega de tokens em tempo real definindo stream: true na sua solicitação. A API retorna um fluxo de Server-Sent Events (SSE), permitindo que você exiba o texto conforme é gerado. Isso melhora a experiência do usuário para interfaces de chat e reduz a latência percebida. Cada fragmento contém uma resposta parcial, e o último fragmento inclui as estatísticas de uso de tokens. Você pode processar esses fragmentos incrementalmente para construir a resposta completa. Este recurso é essencial para aplicativos que exigem feedback imediato. O modelo uncensored suporta streaming para todos os tipos de solicitação. Manipule os eventos do fluxo para atualizar sua interface do usuário de forma eficiente. Use este código para implementar o streaming no seu cliente.

Limites de Taxa & Limites de Contexto

A API impõe limites rigorosos para garantir desempenho estável para todos os usuários. Você pode enviar até 300 solicitações por minuto por chave e tem 8 concurrent requests ativo a qualquer momento. O tamanho máximo do corpo da solicitação é 8 MB. Se você exceder esses limites, receberá um 429 código de status. Certifique-se de lidar com novas tentativas com backoff exponencial para evitar atingir esses limites repetidamente. A janela de contexto é de 100.000 tokens, mas a saída máxima é de 16.000 tokens. Se você precisar de mais saída, ajuste o max_tokens parâmetro. Erros como 401 (chave inválida) e 402 (sem crédito) são imediatos e não consomem sua cota de tokens. Gerencie sua cota cuidadosamente para evitar interrupções de serviço durante tarefas de geração em alto volume.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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

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)