ES ▾
nofilterai.top
NoFilter AI
Obtener clave de API

App de roleplay sin filtros: crea uno con una API

Una API de novia IA proporciona una interfaz dedicada para aplicaciones de chat que simulan interacciones románticas o de compañía usando modelos de lenguaje grandes. Esta guía compara enfoques técnicos, centrándose en modelos sin censura que manejan el contexto del roleplay sin los rechazos de contenido estándar.

Un escenario de teatro en miniatura conectado por un flujo de datos brillante a un servidor, ilustrando la arquitectura de una app de roleplay

La arquitectura en una imagen

El navegador envía el mensaje del usuario a tu servidor. Tu servidor añade la personalidad y el historial reciente, llama al modelo con stream: true y reenvía cada fragmento de vuelta. No se requiere nada más.

  1. Navegador: un cuadro de texto y un div que se expande a medida que llegan los tokens.
  2. Tu servidor: mantiene la clave de API, construye la lista de mensajes, aplica tus propios límites por usuario.
  3. API del modelo: POST /v1/chat/completions en https://api.nofilterai.top/v1 con el modelo uncensored.
  4. Almacenamiento: una tabla o archivo de mensajes por conversación. SQLite es suficiente para empezar.

El modelo es un modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto legal. Es solo texto. Si quieres arte de personajes o voz, añades otro servicio tú mismo.

Diseña el prompt de sistema

Para el roleplay, el prompt de sistema hace la mayor parte del trabajo. Divídelo en tres bloques cortos para poder intercambiar cada uno independientemente: el mundo, el personaje y las reglas del formato.

{
  "world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
  "character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
  "format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}

Únelos en un único mensaje de sistema en el momento de la petición. Mantenerlos separados permite a los usuarios elegir un mundo y un personaje de forma independiente, que es la mayor parte de lo que necesita una app de roleplay. Como la ficción para adultos está permitida para uso adulto legal, dilo una vez en tus propios términos de servicio y añade un control de edad. Lo único que la API no producirá es contenido sexual que involucre a menores, y tu app no debería intentarlo.

El backend de streaming

Esta ruta de Express acepta un ID de conversación y un mensaje, carga el historial y transmite el stream al navegador como eventos enviados por el servidor. Usa el paquete oficial openai.

import express from "express";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nofilterai.top/v1",
  apiKey: process.env.API_KEY,
});

const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages

app.post("/chat", async (req, res) => {
  const { id, text, persona } = req.body;
  const history = store.get(id) ?? [];
  history.push({ role: "user", content: text });

  res.setHeader("Content-Type", "text/event-stream");
  res.setHeader("Cache-Control", "no-cache");

  const stream = await client.chat.completions.create({
    model: "uncensored",
    messages: [{ role: "system", content: persona }, ...trim(history)],
    stream: true,
    temperature: 0.9,
  });

  let reply = "";
  for await (const chunk of stream) {
    const piece = chunk.choices[0]?.delta?.content ?? "";
    if (piece) {
      reply += piece;
      res.write("data: " + JSON.stringify(piece) + "\n\n");
    }
  }
  history.push({ role: "assistant", content: reply });
  store.set(id, history);
  res.write("data: [DONE]\n\n");
  res.end();
});

app.listen(3000);

El último fragmento de un flujo lleva el uso, que puedes registrar para ver cuánto cuesta cada conversación. En producción, reemplaza el Map con una base de datos y añade manejo de errores alrededor de la llamada.

Recorta el historial dentro de la ventana de 100k

La ventana de contexto es de 100.000 tokens para el prompt más la finalización. Las sesiones de roleplay crecen lentamente, pero crecen. Una función de recorte por tamaño evita sorpresas. Una estimación aproximada de 4 caracteres por token es suficiente para presupuestar.

function trim(history, maxChars = 120000) {
  let total = 0;
  const kept = [];
  for (let i = history.length - 1; i >= 0; i--) {
    total += history[i].content.length;
    if (total > maxChars) break;
    kept.unshift(history[i]);
  }
  return kept;
}

120.000 caracteres son aproximadamente 30.000 tokens, muy por debajo del límite, y mantienen cada llamada económica. Súbelo solo si tu historia necesita memoria a largo plazo. Recuerda la regla de coste: cada turno reenvía el historial conservado como entrada a $0,15 por 1M de tokens, así que un prompt de 30.000 tokens cuesta 30.000 / 1.000.000 x $0,15 = $0,0045 por turno antes de la respuesta.

El cliente del navegador

La página lee el streaming SSE con fetch y añade texto a medida que llega. Como la petición es POST, EventSource no encaja, así que analiza el streaming manualmente.

async function send(text) {
  const out = document.getElementById("reply");
  out.textContent = "";
  const r = await fetch("/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
  });
  const reader = r.body.getReader();
  const dec = new TextDecoder();
  let buf = "";
  while (true) {
    const { value, done } = await reader.read();
    if (done) break;
    buf += dec.decode(value, { stream: true });
    const parts = buf.split("\n\n");
    buf = parts.pop();
    for (const p of parts) {
      if (p === "data: [DONE]") break;
      if (p.startsWith("data: ")) {
        out.textContent += JSON.parse(p.slice(6));
      }
    }
  }
}

Funcionalidades que lo hacen sentir como una app

  • Regenerar y editar. Mantén IDs de mensaje. Regenerar significa borrar el último mensaje del asistente y llamar a la API de nuevo con el mismo historial. Editar significa reescribir un mensaje almacenado antes de la siguiente llamada.
  • Configuración por personaje. Guarda temperature, top_p y penalizaciones con cada personaje. Los personajes más tranquilos van bien con 0.7, los caóticos con 1.0. Pasa seed cuando quieras ejecuciones de prueba reproducibles.
  • Visualización de costes. Lee la cabecera de respuesta X-Balance-USD o llama a GET /v1/balance y muestra al usuario cuánto crédito le queda. Si revendes acceso a tus propios usuarios, esto te ahorra muchas preguntas de soporte.
  • Barreras de seguridad que tú controlas. Añade un control de solo adultos, un botón de reporte y una regla que bloquee cualquier petición que involucre a menores antes de que llegue a la API. La plataforma aplica ese límite también, pero tu app debería hacerlo también.

Límites, errores y presupuestos

Una clave completa permite 8 peticiones concurrentes y 300 peticiones por minuto. Una petición en streaming mantiene un espacio de concurrencia hasta que termina el streaming, así que una app de roleplay con 20 usuarios activos alcanzará el límite durante los minutos de mayor actividad. La API responde HTTP 429 con el código concurrency o rate_limited, y en sobrecarga temporal añade Retry-After: 5. Pon las peticiones en cola en tu servidor y reinténtalas después de ese retraso.

Las peticiones fallidas o rechazadas no se cobran, así que los reintentos no te cuestan. Para presupuestar, un turno típico de 3.000 tokens de entrada y 300 tokens de salida cuesta $0,00045 + $0,00015 = $0,0006. El crédito es prepago desde $20 y no caduca. Este sitio acepta cripto, USDT en TRC20 o USDC en Base; la página de precios lista los bonos desde $50 hacia arriba.

A dónde ir a continuación

Consigue una clave y prueba con la prueba gratuita: la página de claves de API ofrece $0,50 de crédito de prueba gratis después del registro, válido por 7 días, sin datos de pago. La clave de prueba permite 2 peticiones simultáneas, suficientes para un prototipo de un solo usuario. La documentación lista todos los parámetros, incluyendo llamadas a funciones si quieres que los dados o el inventario se manejen como llamadas a funciones.

Para una variante estilo compañero con un único personaje persistente, consulta el artículo API de compañero IA. Para un bot de chat dentro de un servidor, lee la guía Bot de Discord.

Preguntas y respuestas

¿Puedo llamar a la API directamente desde el navegador?

Puedes, pero expondrías tu clave a todos los visitantes. Mantén la clave en un servidor y expón solo tu propia ruta.

¿Cómo evito que el modelo escriba las acciones de mi personaje?

Indícalo en el prompt de sistema y, si usas un formato de transcripción, añade una secuencia de detención. Ambos funcionan con los parámetros de paso.

¿Necesita la app guardar las conversaciones?

La API en sí es sin estado, así que reenvías el historial en cada turno. Los prompts no se usan para entrenamiento.

¿Cuál es la forma más barata de hacer un prototipo?

Usa la clave de prueba y un Map en memoria. Pásate a una base de datos y una clave con fondos cuando el bucle funcione.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API