Início rápido: Conecte seu código

Instalação e configuração

A chave da API autentica suas solicitações. Gere uma instantaneamente pelo painel de controle usando Google ou e-mail e senha. Não é necessário número de telefone. Armazene a chave em suas variáveis de ambiente. Ela concede acesso ao único modelo uncensored. Você pode substituir uma chave se necessário, mas apenas uma permanece ativa por vez. A URL base direciona o tráfego para nossos servidores. Funciona com qualquer biblioteca cliente compatível com OpenAI. Altere o base_url parâmetro para apontar aqui. Isso elimina lógica complexa de proxy ou roteamento. Seus prompts e conclusões são contados contra seu crédito pré-pago. Erros não consomem tokens. Isso garante que você pague apenas pela geração real.

Fazendo sua primeira conclusão de chat

Envie uma requisição POST para /v1/chat/completions com seu ID do modelo. Use "uncensored" como o valor do modelo. Inclua suas mensagens de system e user no messages array. A API retorna o texto gerado. Nenhum filtro de conteúdo bloqueia tópicos adultos lícitos. Você pode ajustar parâmetros como temperature ou top_p. Estes controlam aleatoriedade e criatividade. Defina max_tokens limitar o comprimento da saída. O padrão é 2.048 tokens. Você pode estender isso até 16.000 tokens. A janela de contexto suporta 100.000 tokens no total. Isso permite roleplays longos e detalhados. Mantenha suas solicitações abaixo de 8 MB. Esse limite garante desempenho estável para payloads grandes.

Lidando com respostas de streaming

O streaming entrega tokens conforme são gerados. Isso reduz a latência percebida para os usuários. Defina stream: true na sua solicitação. A API retorna um fluxo de Server-Sent Events (SSE). Cada fragmento contém conteúdo parcial. Você pode concatenar esses fragmentos para formar a resposta completa. O último fragmento inclui estatísticas de uso de tokens. Isso ajuda você a rastrear o consumo de créditos com precisão. O streaming é ideal para interfaces de chat em tempo real. Fornece feedback imediato durante a geração. O tratamento de erros permanece consistente, seja em streaming ou não. Verifique o código de status para falhas. Um erro 402 indica crédito insuficiente. Um erro 401 significa que sua chave é inválida. A lógica de nova tentativa deve levar em conta esses códigos específicos.

Usando chamada de função e ferramentas

Defina ferramentas na solicitação para habilitar chamada de funções. O modelo pode retornar dados estruturados para seu aplicativo. Especifique tool_choice para controlar o comportamento de invocação. Use "auto" para seleção automática. Passe as definições de ferramentas no tools array. O modelo responde com chamadas de função quando apropriado. Você executa a função e envia o resultado de volta. O modelo continua a conversa com base na saída. Isso suporta lógica complexa em bots de roleplay. Você pode definir várias ferramentas para diferentes ações. A API cuida do parsing e roteamento. Certifique-se de que os schemas das ferramentas sejam JSON válidos. Isso evita erros durante o processo de chamada de função.

Ativando o modo JSON

Força o modelo a gerar JSON válido. Defina response_format para {"type": "json_object"}. Isso garante dados estruturados para análise. Use isso para estados de jogo ou respostas de API. O modelo não adicionará formatação markdown. Ele retorna apenas JSON bruto. Isso é útil para fluxos de trabalho automatizados. Você pode analisar a saída diretamente no seu código. Erros na estrutura JSON são raros, mas possíveis. Valide a saída na camada de aplicativo. Isso adiciona uma rede de segurança para sistemas de produção. O modo JSON funciona junto com a chamada de funções. Você pode combinar ambos para interações complexas. A janela de contexto se aplica a toda a troca. Planeje o uso de tokens de acordo para permanecer dentro dos limites.

Limites, erros e janela de contexto

Você está limitado a 300 solicitações por minuto por chave. Solicitações simultâneas são limitadas a 8 por chave. Os corpos das solicitações não devem exceder 8 MB. Esses limites impedem a sobrecarga do servidor durante o uso intenso. Erros retornam códigos de status HTTP padrão. 401 indica uma chave inválida ou expirada. 402 sinaliza que seu crédito pré-pago está esgotado. 429 significa que você excedeu o limite de taxa. Aguarde antes de tentar novamente após um erro 429. A janela de contexto é de 100.000 tokens. Isso inclui tokens de prompt e de conclusão. Conversas longas podem exigir estratégias de truncamento. Gerencie o uso de tokens para evitar custos inesperados. O crédito nunca expira, então você pode pausar o uso a qualquer momento. Essa flexibilidade é adequada para geração intermitente de alto volume.

cURL

Copycurl https://api.restrictionsnoai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three spicy dialogue lines for a vampire character"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)