Documentação da API

Início rápido: sua primeira solicitação

Envie sua primeira mensagem para o modelo uncensored imediatamente. Use o endpoint padrão de chat-completions para gerar texto. O modelo responde a prompts de linguagem natural sem recusas de conteúdo para uso adulto legal. Esta configuração funciona com qualquer cliente compatível com OpenAI.

Come instalando o SDK para sua linguagem preferida. Em seguida, configure sua chave de API. O exemplo a seguir mostra uma solicitação curl básica para testar a conectividade.

Você pode ajustar parâmetros como temperatura para controlar a aleatoriedade. A resposta retorna o texto gerado diretamente. Esse fluxo simples permite verificar se a API funciona antes de construir lógica complexa.

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

URL Base e Autenticação

Conecte-se usando o URL base dedicado para esta API. Substitua o endpoint padrão pelo endereço do nosso servidor hospedado. Isso garante que suas solicitações alcancem o modelo sem censura diretamente. A autenticação depende de uma única chave de API por conta.

Gere sua chave pelo painel. Passe-a no cabeçalho Authorization como token Bearer. Este método é compatível com SDKs padrão do OpenAI. Você pode alternar entre provedores alterando apenas o URL base e a chave.

Mantenha sua chave segura. Ela concede acesso total ao seu crédito pré-pago. A chave substitui qualquer chave ativa anterior imediatamente após a geração.

Endpoints: Chat Completions

Interaja com o modelo por meio do endpoint de conclusões de chat. Este é o único endpoint de geração de texto disponível. Ele aceita mensagens e retorna texto gerado. Embeddings, imagens ou áudio não são suportados.

Envie uma solicitação POST para a rota de chat. Inclua suas mensagens de sistema e usuário no corpo. O modelo processa o contexto e gera uma resposta. Você pode usar o modo JSON para saída estruturada.

O suporte a chamadas de função também está disponível. Defina ferramentas e deixe o modelo decidir quando usá-las. Essa flexibilidade permite fluxos de trabalho de agentes complexos. A resposta inclui o conteúdo gerado e o uso de tokens.

Copyfrom openai import OpenAI

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

Parâmetros: Temperatura, Top P e Parada

Controle o estilo da saída usando parâmetros padrão. Ajuste a temperatura para alterar a criatividade. Valores mais baixos tornam as respostas mais determinísticas. Valores mais altos introduzem mais variedade.

Use top P para filtrar palavras improváveis. Isso ajuda a manter a coerência enquanto permite criatividade. Defina sequências de parada para encerrar a geração em marcadores específicos. Isso é útil para controlar a estrutura do diálogo.

O parâmetro seed permite resultados reproduzíveis. Use-o ao depurar seus prompts. Esses parâmetros oferecem controle preciso sobre o comportamento do modelo. Ajuste-os para atender às necessidades da sua aplicação.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicharacter.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 e Uso de Tokens

Receba respostas em tempo real usando server-sent events. O streaming reduz a latência percebida para os usuários. A API envia tokens conforme são gerados. Isso cria uma experiência de leitura mais fluida.

O uso de tokens é relatado no chunk final. Isso permite que você rastreie os custos com precisão. O faturamento é baseado nos tokens realmente consumidos. Erros e recusas não geram cobranças.

Implemente um manipulador de fluxo para processar os dados. Atualize sua interface do usuário conforme os tokens chegam. Essa abordagem é ideal para interfaces de chat. O modelo oferece streaming para todos os tipos de solicitação.

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)

Limites de Taxa e Restrições

Entenda os limites para evitar interrupções no serviço. Você pode fazer 300 solicitações por minuto por chave. Solicitações simultâneas são limitadas a oito ao mesmo tempo. O corpo da solicitação não deve exceder 8 MB.

Trate os erros com elegância. Um status 401 significa que sua chave é inválida. Um status 402 indica crédito insuficiente. Um status 429 sinaliza que você atingiu o limite de taxa.

A janela de contexto suporta 100.000 tokens no total. Isso inclui tanto o prompt quanto a conclusão. A saída máxima é de 16.000 tokens por solicitação. Defina max_tokens para controlar o comprimento da saída. Erros são gratuitos, portanto, a lógica de retry é segura.