Início rápido: integre o chat da apertus ai

Pré-requisitos e Configuração

Comece criando uma conta e obtendo sua chave de API. Cadastre-se usando o Google ou uma senha de e-mail na página de geração de chaves. O sistema exibe sua chave imediatamente, para que você possa copiá-la sem demora. Nenhum número de telefone é necessário para o registro. Você recebe $0.50 em crédito de teste válido por 7 dias, para que possa testar a conectividade sem adicionar fundos.

Configure sua variável de ambiente ou cliente SDK para apontar para a URL base correta. Esta URL funciona com bibliotecas padrão da OpenAI. Altere apenas a URL base e sua chave. O ID do modelo é "uncensored". Este único endpoint lida com todas as conclusões de texto. Você não precisa gerenciar roteamento ou selecionar modelos diferentes.

Garanta que a biblioteca do cliente suporte o protocolo OpenAI Chat Completions. A maioria das SDKs modernas funciona imediatamente. Verifique se sua rede permite solicitações HTTPS de saída. O serviço aceita payloads JSON padrão. Não são necessários cabeçalhos especiais além da autenticação.

Autenticação com chaves de API

Envie sua chave de API no cabeçalho Authorization para cada solicitação. Use o esquema Bearer seguido pela sua string de chave. O serviço valida a chave contra sua conta. Chaves inválidas retornam um erro 401 Unauthorized. Chaves expiradas ou fundos insuficientes acionam uma resposta 402 Payment Required. Verifique seu saldo no painel se as solicitações falharem.

Mantenha sua chave segura. Cada conta mantém uma chave ativa. Gerar uma nova chave invalida a anterior. Não compartilhe sua chave em repositórios públicos. A chave de API é o único identificador para seu uso. Limites de taxa são aplicados por chave, não por conta.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

A autenticação é stateless. O servidor verifica o token em cada chamada. Se você rotacionar sua chave, atualize todos os clientes em execução imediatamente. A ausência do cabeçalho resulta em rejeição imediata. A mensagem de erro indica claramente a falha de autenticação.

Enviando sua primeira solicitação

Envie uma solicitação POST para o endpoint de conclusões de chat. Inclua o ID do modelo "uncensored" e seu histórico de mensagens. A API retorna uma resposta de texto. Você pode transmitir a saída ou aguardar a conclusão completa. Cada solicitação consome tokens de entrada e saída. Erros não cobram créditos. Recusas são gratuitas.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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 resposta inclui estatísticas de uso. Rastreie o consumo de tokens para gerenciar seu crédito pré-pago. O modelo responde sem recusas de conteúdo para uso adulto legal. Você pode enviar prompts de sistema para definir o comportamento. As mensagens do usuário conduzem a conversa. A janela de contexto suporta 100.000 tokens no total.

Come com uma troca simples de duas mensagens. Isso verifica a conectividade e a qualidade da resposta. Ajuste a temperatura e o top_p para saídas criativas ou precisas. A API suporta parâmetros padrão. Sequências de parada funcionam conforme o esperado. Valores de seed garantem resultados reproduzíveis.

Respostas em Streaming via SSE

Ative o streaming definindo o parâmetro stream como true. A API retorna Server-Sent Events (SSE) em vez de um único objeto JSON. Cada chunk contém uma parte do texto gerado. Leia os chunks até o fim do fluxo. O último chunk inclui o uso total 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. Os usuários veem o texto aparecendo em tempo real. Isso é ideal para interfaces de chat. Lidere com cuidado com tokens parciais. Concatene fragmentos para formar a resposta completa. O servidor fecha a conexão quando a geração termina.

Monitore erros de stream. Interrupções de rede podem abortar o stream. Implemente lógica de reconexão se necessário. A API não reenvia o histórico. Inicie uma nova solicitação se o stream falhar. As contagens de tokens no último chunk refletem toda a geração.

Lidando com Parâmetros e Modos

Use parâmetros padrão para controlar a geração. Defina temperatura para aleatoriedade. Ajuste top_p para amostragem de núcleo. Defina sequências de parada para interromper a geração antecipadamente. Passe uma semente para saídas determinísticas. Ative o modo JSON definindo response_format como json_object. O modelo retorna JSON válido quando solicitado.

As chamadas de função são suportadas. Defina ferramentas na solicitação. O modelo retorna chamadas de ferramenta quando apropriado. Analise os argumentos da ferramenta no seu código. Passe os resultados de volta para continuar a conversa. Isso permite fluxos de trabalho de agentes complexos.

Copyimport OpenAI from "openai";

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

Tokens máximos limitam o comprimento da saída. O padrão é 2.048 tokens. Defina um valor mais alto se necessário. O limite rígido por solicitação é de 16.000 tokens. A janela de contexto é de 100.000 tokens. Planeje o comprimento do histórico de acordo. As penalidades de frequência e presença ajudam a reduzir a repetição.

Entendendo Limites e Erros

Os limites de taxa protegem a estabilidade do serviço. Você pode enviar 300 solicitações por minuto. A concorrência é limitada a oito solicitações simultâneas por chave. Os corpos das solicitações não devem exceder 8 MB. Exceder limites retorna um erro 429 Too Many Errors. Aguarde antes de tentar novamente.

Verifique os códigos de erro para diagnóstico. 401 significa chave inválida ou ausente. 402 indica crédito pré-pago insuficiente. Recarregue via criptomoeda para retomar o serviço. 429 sinaliza limite de taxa excedido. 400 denota sintaxe de solicitação inválida. Revise a mensagem de erro para mais detalhes.

O gerenciamento da janela de contexto é crítico. Some os tokens do prompt e da conclusão. Mantenha-se bem abaixo de 100.000 tokens. Trunque mensagens antigas se necessário. A API não faz truncamento automático. Você controla o tamanho do histórico. O uso eficiente do contexto reduz custos.