Documentação da API

Início rápido: Conecte sua Primeira Solicitação

Come gerando sua chave no painel. A URL base para todas as solicitações é HTTPS://api.filterno.cc/v1. Passe sua chave no cabeçalho Authorization como um token bearer. Esta configuração funciona com qualquer cliente padrão compatível com OpenAI.

Teste a conectividade imediatamente com uma solicitação de conclusão simples. O endpoint aceita formatos de chat padrão e retorna texto bruto sem filtros de conteúdo.

Substitua YOUR_API_KEY pela string emitida para a sua conta. O corpo da solicitação define o modelo e o conteúdo da mensagem. Você recebe uma resposta contendo o texto gerado.

Endpoint: POST /v1/chat/completions

Envie seus prompts para POST /v1/chat/completions. Este é o único endpoint de chat que suportamos. Você fornece uma instrução de sistema e mensagens do usuário em um formato de array.

O identificador do modelo é "uncensored". Ele processa entrada de texto e retorna saída de texto. Não espere geração de imagens ou áudio aqui.

Defina a temperatura para controlar a aleatoriedade. Valores mais altos produzem saídas mais criativas. Valores mais baixos resultam em saídas determinísticas. A API segue estritamente o esquema OpenAI para este endpoint.

Endpoint: GET /v1/models

Verifique os modelos disponíveis com uma solicitação GET para /v1/models. Este endpoint retorna uma lista de IDs de modelos suportados. Você deve ver "uncensored" na resposta.

Este endpoint confirma se sua chave de API é válida. Ele também mostra os detalhes do modelo. Use-o para depurar problemas de conectividade.

A resposta inclui o ID do modelo e o tipo de objeto. Ela não lista preços ou limites. Consulte a documentação para as taxas de tokens.

Parâmetros: Temperatura, Top-P e Tools

Controle a diversidade da geração com temperature e top_p. Temperature ajusta a distribuição de probabilidade. Top_p filtra tokens de baixa probabilidade. Juntos, eles equilibram criatividade e foco.

Use chamadas de função para interações estruturadas. Defina ferramentas no corpo da solicitação. O modelo pode chamar essas funções. Passe tool_choice para impor comportamento específico.

Defina sequências stop para encerrar a geração antecipadamente. Use seed para resultados reproduzíveis. Penalidades de presença e frequência reduzem a repetição. Esses parâmetros seguem as convenções padrão do OpenAI.

Respostas em Streaming (SSE) e Uso de Tokens

Ative o streaming definindo stream como true. A API retorna Eventos Enviados pelo Servidor (SSE). Cada fragmento contém dados parciais de token.

O uso de tokens aparece no último chunk. Leia para rastrear os custos. O streaming reduz a latência percebida para respostas longas. É ideal para aplicativos em tempo real.

Analise a estrutura de dados SSE com cuidado. Lidere com interrupções de rede de forma graciosa. A API garante a integridade dos dados através dos limites dos chunks.

Limites, Erros e Aritmética de Tokens

Você tem direito a 300 requisições por minuto por chave. A concorrência é limitada a 8 requisições simultâneas. O tamanho máximo do corpo da requisição é de 8 MB.

A janela de contexto é de 100.000 tokens. Isso inclui prompt e conclusão. A saída máxima é de 16.000 tokens. Defina max_tokens para limitar o uso.

Lide com erros verificando os códigos de status. 401 significa chave inválida. 402 indica sem crédito. 429 sinaliza limite de taxa. Tente novamente com backoff exponencial para 429.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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