Início Rápido da API

URL Base e Autenticação

Come apontando seu cliente para nossa URL base e passando sua chave no cabeçalho. Utilizamos o esquema padrão de Authorization, portanto, qualquer SDK ou cliente compatível com OpenAI funciona imediatamente. Você não precisa gerenciar fluxos complexos de OAuth nem aguardar aprovação. Basta se cadastrar com Google ou e-mail, copiar a chave e estar pronto. O endpoint é https://api.aiohnezensur.com/v1 e aceita o Authorization: Bearer YOUR_API_KEY cabeçalho em cada solicitação.

Enviando sua primeira solicitação

Faça uma chamada simples de chat completion para testar o modelo uncensored. Esta solicitação envia um prompt e recebe uma resposta em texto sem as proteções corporativas habituais. Você pode usar qualquer ferramenta que suporte o protocolo OpenAI, mas uma chamada curl direta mostra exatamente o que acontece nos bastidores. Substitua YOUR_API_KEY com sua chave real no painel.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

A resposta inclui o texto gerado e as estatísticas de uso de tokens. Se você receber uma resposta, sua integração está funcionando corretamente. Agora você pode prosseguir para construir interações mais complexas ou mudar para clientes programáticos.

Integração do SDK Python

Use o pacote Python oficial da OpenAI para interagir com nossa API sem problemas. Defina a URL base para o nosso endpoint e forneça sua chave como o token da API. Isso permite que você aproveite bases de código existentes sem reescrever a lógica HTTP. O ID do modelo é uncensored, que aciona nosso modelo de linguagem grande específico ajustado para saída sem restrições.

Copyfrom openai import OpenAI

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

Este snippet demonstra uma troca básica de mensagens. Você pode ajustar o array de mensagens para incluir prompts de sistema ou histórico de conversação. O SDK cuida da serialização e análise de erros para você.

Integração do SDK Node

Integre a API em seus aplicativos JavaScript ou TypeScript usando o SDK Node. Configure a URL base e a chave de API exatamente como no exemplo Python. Esta abordagem funciona bem para renderização no lado do servidor ou microsserviços backend. O SDK abstrai a camada de rede, permitindo que você se concentre na lógica do prompt.

Copyimport OpenAI from "openai";

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

Execute este código para ver o modelo responder ao seu input. Você pode iterar rapidamente alterando o conteúdo do prompt. A estrutura da resposta corresponde ao formato padrão OpenAI, garantindo compatibilidade com outras ferramentas na sua stack.

Respostas em Streaming

Ative o streaming para receber tokens à medida que são gerados, reduzindo a latência percebida. Isso é crucial para interfaces de usuário que exibem texto em tempo real. Defina o stream parâmetro para true na sua solicitação. A API envia uma série de Server-Sent Events (SSE) em vez de um único objeto JSON. Cada fragmento contém um delta parcial da resposta.

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)

Concatene esses deltas no lado do cliente para reconstruir a mensagem completa. Esse método parece instantâneo para o usuário, mesmo para saídas longas. O último chunk contém o uso total de tokens, permitindo que você facture com precisão.

Limites de Taxa e Restrições

Entenda os limites técnicos para evitar falhas de solicitação em produção. Você tem permissão para 300 solicitações por minuto por chave e pode ter 8 solicitações simultâneas. O corpo da solicitação não deve exceder 8 MB. Se você exceder esses limites, a API retorna o código de status 429. Você deve implementar backoff exponencial no seu cliente para lidar com esses picos com elegância. A janela de contexto é de 100.000 tokens no total, com uma saída máxima de 16.000 tokens por solicitação. Erros e recusas não consomem crédito, então você pode tentar novamente com segurança. Erros de autenticação retornam 401, e fundos insuficientes retornam 402.