Instalação e configuração
Comece instalando o SDK oficial para a sua linguagem. O cliente requer apenas sua chave de API e a URL base correta para rotear solicitações para nossos servidores. Esta configuração funciona com qualquer cliente padrão compatível com OpenAI.
Configure as variáveis de ambiente ou passe-as diretamente para o construtor do cliente. Você não precisa gerenciar lógica complexa de roteamento ou alternar entre vários modelos. O único modelo uncensored lida com todas as solicitações.
- Instale o pacote via seu gerenciador de pacotes.
- Defina a chave da API no painel.
- Aponte o cliente para o endpoint da API.
Fazendo sua primeira solicitação
Envie uma solicitação POST para o endpoint de conclusões de chat com o ID do modelo definido como "uncensored". Isso retorna uma resposta de texto direta do modelo, contornando os filtros de conteúdo padrão. Você pode enviar prompts simples ou instruções de sistema complexas.
A API aceita parâmetros padrão como temperatura e top_p. Use o seguinte comando cURL para verificar a conectividade e a qualidade da resposta imediatamente.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'Esta resposta confirma que o modelo está ativo e pronto para tráfego de produção.
Lidando com respostas de streaming
Ative o streaming definindo o parâmetro stream como true. A API retorna um fluxo de server-sent events (SSE), entregando tokens conforme são gerados. Isso reduz significativamente a latência percebida para os usuários finais.
Analise os chunks SSE para atualizar sua interface do usuário em tempo real. O último chunk inclui o uso total de tokens para a solicitação. Esta abordagem é essencial para interfaces de chat onde os usuários esperam feedback instantâneo.
stream = 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)Garanta que seu cliente lide corretamente com o evento de término do stream.
Usando ferramentas e chamada de funções
Defina ferramentas na solicitação para permitir que o modelo gere chamadas de ferramentas estruturadas. Passe as definições de ferramentas no array tools e especifique tool_choice para seleção automática. O modelo retorna chamadas de função no conteúdo da resposta.
Analise os argumentos da função e execute-os no seu código. Em seguida, passe os resultados de volta para o modelo em uma mensagem subsequente. Este ciclo permite fluxos de trabalho complexos em várias etapas sem lógica de análise externa.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);Valide sempre o esquema de saída antes da execução.
Gerenciamento de tokens e limites
A janela de contexto suporta 100.000 tokens combinados para prompt e conclusão. Cada solicitação pode gerar até 16.000 tokens, ou 2.048 se max_tokens for omitido. Monitore seu uso por meio das contagens de tokens na resposta.
Os limites de taxa permitem 300 solicitações por minuto e 8 solicitações simultâneas por chave. Exceder esses limites aciona um erro 429. Mantenha sua chave exclusiva por conta para evitar compartilhar limites.
Erros como 401 indicam uma chave inválida, enquanto 402 significa que você precisa de mais crédito. Recusas por violações menores de conteúdo são gratuitas e não consomem tokens.
Tratamento de erros e solução de problemas
Trate erros HTTP gracefulmente na lógica da sua aplicação. Um status 401 significa que sua chave de API está incorreta ou expirada. Verifique seu painel para garantir que a chave está ativa.
Um status 402 indica crédito pré-pago insuficiente. Recarregue usando USDT ou USDC para retomar o serviço. O erro 429 indica que você atingiu o limite de taxa. Aguarde e tente novamente com backoff exponencial.
Corpos de solicitação inválidos retornam um erro 400. Verifique se a estrutura do JSON corresponde à especificação da API. Esses erros são gratuitos e não deduzem do seu saldo.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)