Início rápido da API Uncensored AI

Pré-requisitos e configuração do URL base

Come registrando uma conta via Google ou e-mail na página de chaves. Sua chave de API aparece imediatamente e serve como a única credencial para todas as solicitações. A URL base do serviço é https://api.uncensoredroleplayai.com/v1, que funciona com qualquer cliente compatível com OpenAI.

Configure suas variáveis de ambiente ou cliente SDK para apontar para esta URL. Este único endpoint lida com todas as conclusões de texto. Você não precisa gerenciar roteamento de modelos ou selecionar entre vários fornecedores. O identificador do modelo é sempre uncensored, um modelo de peso aberto ajustado para conteúdo adulto e fictício.

Autenticação com chaves de API

Inclua sua chave de API no Authorization cabeçalho como um token Bearer. Cada solicitação deve conter este cabeçalho para autenticar sua identidade. Se a chave estiver ausente ou inválida, o servidor retornará um erro 401 Unauthorized. Verifique o painel da sua conta se suspeitar que a chave foi revogada.

Cada conta possui uma chave ativa por vez. Gerar uma nova chave substitui imediatamente a anterior. Não há limite para o número de chaves que você pode gerar historicamente, mas apenas a atual funciona. Use esta única chave em todos os seus serviços.

Enviando sua primeira conclusão de chat

Faça uma solicitação POST para o /v1/chat/completions endpoint. endpoint. Passe o nome do modelo uncensored e o histórico da sua conversa no messages array. O sistema retorna uma resposta de texto sem filtrar tópicos adultos lícitos.

• Defina o modelo para uncensored.
• Inclua sua prompt do sistema para definir a persona de roleplay.
• Envie mensagens do usuário para impulsionar a narrativa.

Verifique se a estrutura da resposta contém o texto gerado. Isso confirma que sua integração está funcionando corretamente com a API de LLM sem censura.

Lidando com respostas de streaming

Ative o streaming definindo stream para true em sua solicitação. A API envia fragmentos via Eventos Enviados pelo Servidor (SSE). Cada fragmento contém texto parcial e metadados. Processe esses fragmentos em tempo real para exibir a resposta conforme é gerada.

Os detalhes de uso de tokens aparecem no último chunk. Isso permite que você rastreie os custos com precisão sem esperar que toda a resposta seja finalizada. O streaming é ideal para bots de roleplay onde a latência importa. Use o SDK Node para lidar facilmente com esses eventos.

Configurando parâmetros para roleplay

Ajuste parâmetros como temperature e top_p para controlar a criatividade. Temperaturas mais altas produzem saídas mais diversas e imprevisíveis. Use stop sequências para encerrar respostas em frases específicas. O modo JSON está disponível via response_format para dados estruturados.

Definir max_tokens para controlar o comprimento da saída. O padrão é 2.048 tokens, mas você pode solicitar até 16.000. A janela de contexto suporta 100.000 tokens no total. Isso permite continuidade em textos longos sem perder o contexto. Ajuste essas configurações para o seu caso de uso específico.

Entendendo o uso e o preço dos tokens

O preço é transparente: $0.15 por milhão de tokens de entrada e $0.50 por milhão de tokens de saída. Erros e recusas são gratuitos. O crédito é pré-pago e nunca expira. Adicione saldo via criptomoedas com USDT (TRC20) ou USDC (Base).

Os limites incluem 300 requisições por minuto e 8 requisições simultâneas por chave. O tamanho do corpo da requisição é limitado a 8 MB. Se ficar sem crédito, você receberá um erro 402 Payment Required. Monitore seu uso pelo painel para evitar interrupções.

cURL

Copycurl https://api.uncensoredroleplayai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
  }'

Python

Copyfrom openai import OpenAI

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