Documentação da API

URL Base e autenticação

Conecte sua aplicação apontando para o nosso endpoint dedicado e passando sua chave de API exclusiva. A URL base para todas as solicitações é https://api.apertusapp.com/v1. Você obtém sua chave imediatamente após o cadastro via Google ou e-mail no Obter chave de API página. Inclua esta chave no Authorization cabeçalho para cada solicitação.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Cada conta gera uma chave ativa. Se você gerar uma nova chave, a anterior torna-se inválida instantaneamente. Isso garante controle rigoroso sobre seu acesso sem planos de assinatura ou taxas ociosas.

Primeira solicitação

Envie seu primeiro prompt para o endpoint de conclusões de chat para receber texto bruto e sem filtros. Use o ID do modelo uncensored para acessar nosso modelo de peso aberto específico ajustado para uso adulto lícito e tópicos controversos.

Copyfrom openai import OpenAI

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

A API aceita parâmetros padrão como temperature e top_p. Erros e recusas não consomem tokens, então você paga apenas pelo que realmente chega ao modelo. Essa abordagem mantém os custos previsíveis em comparação com agregadores que cobram por sobrecarga de roteamento.

Integração do SDK Node

Use o SDK oficial do Node para lidar com o modo JSON e a chamada de funções de forma eficiente. Defina response_format para {"type": "json_object"} para saídas estruturadas ou definir ferramentas para comportamento semelhante a agentes.

Copyimport OpenAI from "openai";

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

O modelo suporta chamadas de ferramentas com tool_choice opções. Você também pode definir um seed para resultados determinísticos. Essa flexibilidade permite que você construa aplicativos complexos sem sair do ecossistema compatível com OpenAI.

Respostas de streaming

Transmita tokens em tempo real usando Server-Sent Events (SSE) para experiências de usuário de baixa latência. Cada bloco contém o texto gerado, e o último bloco inclui estatísticas totais de uso de tokens.

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)

O streaming reduz a latência percebida para o usuário final. Você pode interromper o fluxo se o usuário mudar de ideia. A API lida com o protocolo SSE automaticamente, exigindo código mínimo do seu lado.

Janela de contexto e capacidade

O modelo suporta uma janela de contexto de 100.000 tokens para entrada e saída combinadas. Você pode especificar até 16.000 tokens por solicitação, ou voltar para 2.048 tokens se omitir max_tokens.

Essa janela grande permite análise extensiva de documentos ou históricos de conversas longas. No entanto, mantenha os corpos das solicitações abaixo de 8 MB. O modelo não é GPT ou Llama; é um modelo distinto de IA sem censura otimizado para o seu caso de uso específico.

Tratamento de erros e limites

Lide com erros HTTP padrão de forma elegante para manter um fluxo de aplicativo robusto. Um 401 erro indica uma chave de API inválida ou ausente. Uma 402 erro significa que seu crédito pré-pago foi esgotado. Uma 429 erro sinaliza que você excedeu 300 solicitações por minuto ou 8 solicitações simultâneas.

O crédito nunca expira, então você pode pausar o uso e retomar mais tarde. Erros como cobranças duplas são corrigidos pela página de Suporte. O crédito pré-pago é cobrado apenas pelo consumo real de tokens, garantindo preços transparentes para cada byte.