Referência da API GitHub Uncensored AI

Autenticação & URL Base

A API requer um token bearer para cada solicitação. Você gera essa chave instantaneamente pelo painel usando credenciais do Google ou de e-mail. Uma vez criada, a chave autentica sua conta pré-paga contra o modelo hospedado.

Defina seu URL base para apontar diretamente para nosso gateway de API. Isso garante que todas as solicitações sejam roteadas para o servidor correto do modelo uncensored.

Use o cabeçalho de Autorização padrão com o esquema Bearer. Substitua o espaço reservado pela sua string de chave única.

Configuração Base

• URL Base: https://api.githubuncensoredai.com/v1
• Cabeçalho de Autenticação: Authorization: Bearer YOUR_API_KEY
• ID do Modelo: uncensored

Copycurl https://api.githubuncensoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
  }'

Endpoint Chat Completions

Envie dados de texto para o endpoint de conclusões de chat e receba texto gerado em resposta. O sistema aceita uma lista de mensagens com papéis como user ou assistant. Ele retorna uma conclusão baseada no histórico do prompt.

Este endpoint lida com fluxos de conversa padrão. Você pode enviar várias rodadas, e o modelo mantém o contexto até o limite. Não suporta entradas de imagens, áudio ou vídeo. O formato da resposta é JSON padrão.

Certifique-se de que seu payload inclua o identificador do modelo. O sistema ignora campos desconhecidos com graça. Erros retornam códigos específicos se a autenticação falhar ou os créditos acabarem.

Copyfrom openai import OpenAI

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

Respostas em Streaming

Habilite o streaming definindo o sinalizador stream como true. A API retorna uma série de Server-Sent Events em vez de um único objeto JSON. Cada evento contém um chunk do texto gerado.

Esta abordagem reduz a latência percebida para respostas longas. Você pode começar a exibir o texto para os usuários conforme ele é gerado. O último chunk inclui as estatísticas de uso de tokens para faturamento.

Manipule o stream de forma eficiente no código do cliente. Feche a conexão quando o stream terminar ou ocorrer um erro. Este método funciona bem para interfaces de chat em tempo real.

Copyimport OpenAI from "openai";

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

Function Calling & JSON Mode

O modelo suporta saída estruturada via chamada de funções. Defina ferramentas em sua solicitação com nomes, descrições e esquemas de parâmetros. O modelo seleciona a ferramenta apropriada e gera argumentos.

Use o modo JSON para conformidade estrita de esquema. Defina o formato de resposta como json_object para forçar a saída de JSON válido. Isso é útil para analisar dados ou gerar trechos de código.

Combine chamada de funções com streaming para experiências interativas. O modelo pode invocar várias ferramentas em sequência. Valide o esquema de saída antes de executar funções na lógica do seu aplicativo.

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)

Parâmetros & Limites

Controle o comportamento da geração com parâmetros como temperature e top_p. Ajuste esses valores para equilibrar criatividade e determinismo. As configurações padrão funcionam para a maioria dos propósitos gerais.

Respeite os limites de solicitação para evitar erros. Você pode enviar até 300 solicitações por minuto por chave. As solicitações simultâneas são limitadas a oito por chave. O tamanho máximo do corpo da solicitação é de 8 MB.

A janela de contexto abrange 100.000 tokens. Isso inclui tokens de prompt e conclusão. A saída é limitada a 16.000 tokens por solicitação. Exceder esses limites retorna um código de erro.

Uso de Tokens e Faturamento

A cobrança é pré-paga e baseada no uso real de tokens. Tokens de entrada custam $0.15 por milhão e tokens de saída custam $0.50 por milhão. Erros e recusas não consomem créditos.

O crédito nunca expira. As recargas são processadas apenas via criptomoedas. Você recebe crédito bônus para depósitos maiores. O sistema rastreia o uso com precisão para cada chave de API.

Monitore seu saldo pelo painel. Se os créditos acabarem, suas requisições falharão com um código de erro específico. Adicione fundos instantaneamente para retomar o serviço sem esperar aprovações.