Guia de Integração: API de Completions de Chat

URL Base e Autenticação

A API abliterada funciona como uma substituição direta para endpoints padrão do OpenAI. Você encaminha as solicitações para https://api.aiabliterated.cc/v1 e autentique usando um token Bearer no Authorization cabeçalho. Esta configuração funciona com qualquer cliente que suporte o protocolo OpenAI.

• URL Base: https://api.aiabliterated.cc/v1
• Cabeçalho de Autenticação: Authorization: Bearer YOUR_API_KEY
• ID do Modelo: uncensored

A autenticação é rigorosa. Se você enviar uma chave inválida, o sistema retorna um erro 401 imediatamente.

O Endpoint /v1/chat/completions

Envie seus dados de prompt para o /v1/chat/completions endpoint para receber respostas de texto. O sistema espera um payload JSON contendo o identificador do modelo e seu histórico de mensagens. Esta é uma interface apenas para texto; não espere geração de imagens ou áudio.

O modelo processa entrada e saída dentro de uma janela de contexto de 100.000 tokens. Se você não especificar um limite, o sistema gera 2.048 tokens por solicitação como padrão. Você pode ajustar isso até um máximo rígido de 16.000 tokens.

Copyfrom openai import OpenAI

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

Respostas em Streaming e Uso de Tokens

Ative o streaming definindo stream: true na carga útil da sua solicitação. A API retorna um fluxo de Eventos Enviados pelo Servidor (SSE) de tokens parciais. Isso reduz significativamente a latência percebida para aplicativos interativos.

Os dados de uso de tokens não são enviados com cada chunk. Em vez disso, o último chunk do fluxo contém as estatísticas completas de uso para aquela solicitação. Esse design mantém o fluxo leve enquanto fornece dados de faturamento precisos. Erros durante o streaming são tratados fechando a conexão com um objeto JSON de erro.

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)

Chamada de Função e Modo JSON

O modelo abliterado suporta saídas estruturadas por meio do response_format parâmetro. Defina isso como {"type": "json_object"} para forçar conformidade estrita com JSON. Isso é essencial para integração confiável com sistemas de backend.

Chamada de função também está disponível. Defina ferramentas na sua solicitação, e o modelo gerará JSON válido correspondente ao seu esquema. O sistema não valida suas definições de ferramenta, então certifique-se de que seus esquemas estejam corretos antes de enviar solicitações. Essa capacidade permite arquiteturas de agente complexas sem camadas de análise externas.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiabliterated.cc/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: Temperatura, Top-P e Seed

Controle a aleatoriedade das suas saídas usando parâmetros de amostragem padrão. O temperature valor ajusta a criatividade, enquanto top_p limita a amostragem do núcleo. Use seed para saídas determinísticas quando você precisa de resultados reproduzíveis para depuração.

Outros parâmetros disponíveis incluem stop sequências, presence_penalty, e frequency_penalty. Eles permitem controle refinado sobre a repetição de tokens e adesão ao tópico. O modelo sem censura responde bem a configurações de temperatura baixa para geração de código e temperaturas altas para escrita criativa.

Limites de Taxa e Restrições

A API impõe limites rigorosos para garantir estabilidade para todos os usuários. Você está limitado a 300 requisições por minuto por chave. Requisições simultâneas são limitadas a 8 ao mesmo tempo. Cada corpo de requisição não deve exceder 8 MB.

Se você exceder esses limites, o sistema retornará um erro 429 Too Many Requests. A cobrança é baseada no uso real de tokens. Erros e recusas não consomem seu crédito pré-pago. Você pode gerenciar sua chave diretamente pelo painel se precisar rotacionar as credenciais devido a essas restrições.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'