Documentación de la API

Inicio rápido: Conecta tu primera solicitud

Empieza por generar tu clave en el panel de control. La URL base para todas las solicitudes es HTTPS://api.filterno.cc/v1. Pasa tu clave en el encabezado Authorization como un token bearer. Esta configuración funciona con cualquier cliente estándar compatible con OpenAI.

Prueba la conectividad inmediatamente con una solicitud de completion simple. El endpoint acepta formatos de chat estándar y devuelve texto sin filtros de contenido.

Reemplaza YOUR_API_KEY con la cadena emitida a tu cuenta. El cuerpo de la solicitud define el modelo y el contenido del mensaje. Recibes una respuesta que contiene el texto generado.

Punto final: POST /v1/chat/completions

Envía tus prompts a POST /v1/chat/completions. Este es el único endpoint de chat que admitimos. Proporcionas una instrucción del sistema y mensajes de usuario en un formato de matriz.

El identificador del modelo es "uncensored". Procesa entrada de texto y devuelve salida de texto. No esperes generación de imágenes o audio aquí.

Establece la temperatura para controlar la aleatoriedad. Los valores más altos producen salidas más creativas. Los valores más bajos generan resultados deterministas. La API sigue estrictamente el esquema de OpenAI para este endpoint.

Punto final: GET /v1/models

Verifica los modelos disponibles con una solicitud GET a /v1/models. Este extremo devuelve una lista de IDs de modelos compatibles. Deberías ver "uncensored" en la respuesta.

Este extremo confirma que tu clave API es válida. También muestra los detalles del modelo. Úsalo para depurar problemas de conectividad.

La respuesta incluye el ID del modelo y el tipo de objeto. No lista precios ni límites. Consulta la documentación para las tarifas de tokens.

Parámetros: Temperatura, Top-P y Tools

Controla la diversidad de generación con temperature y top_p. Temperature ajusta la distribución de probabilidad. Top_p filtra los tokens de baja probabilidad. Juntos equilibran la creatividad y el enfoque.

Usa la llamada a funciones para interacciones estructuradas. Define las herramientas en el cuerpo de la solicitud. El modelo puede llamar a estas funciones. Pasa tool_choice para imponer un comportamiento específico.

Establece secuencias de parada para finalizar la generación temprano. Usa seed para resultados reproducibles. Las penalizaciones de presencia y frecuencia reducen la repetición. Estos parámetros siguen las convenciones estándar de OpenAI.

Respuestas en streaming (SSE) y uso de tokens

Activa la transmisión estableciendo stream en true. La API devuelve Eventos Enviados por Servidor (SSE). Cada fragmento contiene datos parciales de tokens.

El uso de tokens aparece en el último fragmento. Léelo para rastrear los costos. El streaming reduce la latencia percibida en respuestas largas. Es ideal para aplicaciones en tiempo real.

Analiza la estructura de datos SSE con cuidado. Maneja las interrupciones de red de forma elegante. La API garantiza la integridad de los datos a través de los límites de fragmentos.

Límites, Errores y Aritmética de Tokens

Obtienes 300 solicitudes por minuto por clave. La concurrencia está limitada a 8 solicitudes simultáneas. El tamaño máximo del cuerpo de la solicitud es de 8 MB.

La ventana de contexto es de 100.000 tokens. Esto incluye el prompt y la respuesta. La salida máxima es de 16.000 tokens. Establece max_tokens para limitar el uso.

Gestiona los errores comprobando los códigos de estado. 401 significa clave inválida. 402 indica sin crédito. 429 señala límite de frecuencia. Reintenta con retroceso 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);

Transmisión

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)