Documentação da API

Autenticação e URL Base

A API requer uma única chave de API para autenticação. Você recebe essa chave imediatamente após se registrar com Google ou um endereço de e-mail. Passe-a no Authorization cabeçalho como um token Bearer. A URL base é https://api.topuncensored.com/v1. Este URL funciona com qualquer SDK ou biblioteca de clientes compatível com OpenAI.

• Use o cabeçalho: Authorization: Bearer YOUR_API_KEY
• Defina o URL base do seu cliente para o endpoint fornecido.

Esta configuração garante que você possa trocar bibliotecas sem alterar sua lógica principal.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Chat Completions

Envie prompts de texto para o /v1/chat/completions endpoint. endpoint. O ID do modelo é uncensored. Esse endpoint lida com formatação de chat padrão com mensagens. Ele retorna respostas de texto diretamente. Não há camadas extras ou wrappers. Você controla a janela de contexto de 100.000 tokens. Solicitações abaixo de 8 MB funcionam com confiabilidade. Use isso para geração de texto direta.

Estruture sua solicitação com um prompt de system e uma mensagem de user. O modelo responde sem filtrar conteúdo adulto legal. Erros como chaves ausentes retornam 401. Ficou sem crédito? Você recebe um erro 402. Esses são sinais claros.

Respostas em Streaming

Ative o streaming definindo stream: true. Você recebe chunks de texto conforme são gerados. Isso reduz a latência percebida para saídas longas. O último chunk inclui dados de uso de tokens. Use isso para exibições em tempo real ou renderização progressiva. É eficiente para aplicações de alto volume.

Analise cada chunk para construir sua resposta final. Este método lida bem com saídas grandes. A API suporta Server-Sent Events padrão. Esta é a abordagem recomendada para aplicativos interativos.

Copyfrom openai import OpenAI

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

Chamada de Ferramentas e Modo JSON

Use chamadas de função para interações estruturadas. Defina ferramentas na sua solicitação. O modelo retorna argumentos estruturados. Defina response_format para {"type": "json_object"} para saída JSON estrita. Isso garante formatos de dados previsíveis. Combine esses recursos para integrações robustas. Você obtém controle preciso sobre a estrutura da saída.

A chamada de ferramentas funciona com o esquema padrão da OpenAI. O modo JSON força JSON válido. Use isso para integrações de API ou extração de dados. Essa flexibilidade suporta fluxos de trabalho complexos.

Copyimport OpenAI from "openai";

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

Parâmetros e Limites

Ajustar temperature, top_p, e stop sequências. Defina max_tokens para 16.000. O padrão é 2.048 se omitido. Controle a repetição com presence_penalty e frequency_penalty. Use seed para saídas determinísticas. Esses parâmetros refinam a qualidade da geração. Você tem controle total sobre o estilo de saída.

Os limites de taxa são de 300 solicitações por minuto. As solicitações simultâneas são limitadas a 8. Esses limites garantem desempenho estável. Monitore seu uso pelo painel. Ajuste os parâmetros para otimizar para seu caso de uso específico.

Erros e Janela de Contexto

Trate os erros com elegância. 401 significa chave inválida. 402 indica crédito insuficiente. 429 sinaliza limites de taxa. A janela de contexto é de 100.000 tokens no total. A saída máxima é de 16.000 tokens. Gerencie seus tokens com sabedoria. Erros não consomem crédito. Isso economiza dinheiro durante a depuração. Use o último fragmento para estatísticas de uso.

Acompanhe o uso de tokens. Evite atingir os limites de taxa. Retente com backoff exponencial. Isso garante uma operação confiável. A API é projetada para robustez. Lidere com erros como parte do fluxo normal.

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)