ES ▾
Obtener clave de API

Alternativa a OpenRouter para Janitor AI: Guía de configuración configuración

Las interfaces de chat de personajes que aceptan una API compatible con OpenAI pueden conectarse a este endpoint con tres valores: una URL, una clave y un nombre de modelo. Aquí tienes la configuración exacta, un prompt de sistema inicial y los límites a tener en cuenta.

Actualizado

Escenario con burbujas de chat brillantes y máscaras conectadas por un cable a un cubo de servidor pequeño

Puntos clave

  1. Ingresa la URL base https://api.openrouterapi.cc/v1, tu clave y el ID del modelo uncensored.
  2. Prueba primero con curl, para saber si el problema es la clave o el cliente.
  3. Un historial de roleplay de 30.000 tokens cuesta unos $0,0047 por respuesta, por lo que 100 respuestas suman aproximadamente $0,47.
  4. El modelo es solo de texto y tiene una ventana de contexto de 100.000 tokens.

Empieza con crédito de prueba

Correo y contraseña; la clave aparece al instante en pantalla.

Obtener clave de API

Lo que necesitas ingresar

Si buscas una alternativa a OpenRouter para Janitor AI o una app de chat de personajes similar, la configuración es la misma que para cualquier proveedor compatible con OpenAI. Busca el lugar en tu cliente donde agregas una API personalizada o proxy. Las diferentes apps lo etiquetan de distinta forma: "proxy", "endpoint de OpenAI personalizado", "URL de API". Los campos de abajo son siempre los mismos tres.

CampoValor
URL de API / URL basehttps://api.openrouterapi.cc/v1
Clave de APILa clave de tu cuenta, enviada como Authorization: Bearer
Nombre del modelouncensored

Algunos clientes quieren el endpoint completo en lugar de la base. Si guardar la URL base da un error o 404, prueba https://api.openrouterapi.cc/v1/chat/completions. Los dos métodos admitidos son POST /v1/chat/completions y GET /v1/models, por lo que un cliente que liste modelos llamará al segundo y verá uncensored.

Si aún no tienes una clave, regístrate con Google o con correo electrónico y contraseña y sigue las instrucciones de la clave de API. Las cuentas nuevas pueden reclamar un crédito de prueba de $0,50 con un clic, que es suficiente para una primera sesión de prueba.

Prueba la conexión antes de culpar a la aplicación

Las interfaces de roleplay ocultan el texto de error en bruto. Ejecuta una petición desde una terminal primero, para saber que la clave y el modelo funcionan. Reemplaza el marcador con tu clave.

curl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

Si esto devuelve una respuesta, el endpoint y la clave están bien, y cualquier problema está en la configuración de la app. Si falla, el cuerpo del error te dice por qué. Conserva el ID de solicitud de la cabecera X-Request-Id de la respuesta; te ayudará al escribir a support.

Un prompt de sistema inicial

Una tarjeta de personaje en una interfaz suele convertirse en el mensaje de sistema. Lo que haga tu app, el modelo recibe algo similar al texto de abajo. El modelo está ajustado para responder sin rechazos de contenido para uso adulto legal, por lo que el prompt no necesita discutir con él. Necesita ser claro sobre la voz, los límites y el formato.

Eres Mara Voss, ingeniera jefe del carguero Calloway.

Voz: seca, práctica, rápida para bromear bajo estrés.

Escribe en tercera persona pasado, 2 a 4 párrafos cortos.

Nunca hables ni actúes por el personaje del usuario.

Mantén la continuidad: rastrea lesiones, reparaciones y quién sabe qué.

Mantente en la historia. Todos los personajes son adultos.

Dos hábitos mejoran las sesiones largas. Primero, mantén el prompt de sistema corto, porque se reenvía en cada turno. Segundo, pon las reglas estrictas al final del prompt, no en el medio, para que permanezcan prominentes cuando crezca el historial del chat. Si tu app te permite agregar una "nota del autor" o un recordatorio que se inserta cerca del último mensaje, úsalo para las reglas de estilo.

Una regla es fija en este servicio y en tu prompt: no contenido sexual que involucre menores. Escribir eso en la tarjeta de personaje también mantiene tus propias tarjetas limpias.

Configuraciones que suelen funcionar

Estos son puntos de partida, no garantías. Cambia uno a la vez y compara algunas respuestas.

  • Temperatura 0,8 a 1,0 para diálogo animado. Baja a alrededor de 0,6 si el personaje se desvía o se contradice.
  • top_p 0.9 a 0.95 si tu cliente lo expone. Se reenvía.
  • Penalizaciones de frecuencia y presencia 0,2 a 0,5 cuando las respuestas empiezan a repetir frases. Valores grandes hacen que la prosa sea extraña, así que mantén valores bajos.
  • max_tokens es opcional. Establece 300 a 600 si quieres respuestas de longitud de párrafo y no ensayos.
  • Streaming activado. La respuesta aparece mientras se escribe, y el último fragmento lleva el uso para que tu cliente pueda mostrar los recuentos de tokens.
  • seed se pasa a través, lo cual es útil cuando quieres comparar dos versiones de prompt en el mismo turno.

Streaming tiene un único efecto secundario que vale la pena conocer: una petición en streaming ocupa su ranura de concurrencia hasta que finaliza el flujo. Una clave completa permite 8 peticiones a la vez y 300 por minuto. Una clave de prueba permite 2 a la vez y 60 por minuto.

Contexto, memoria y el costo de chats largos

La ventana de contexto es de 100.000 tokens, prompt más respuesta. Eso es mucha historia: decenas de miles de palabras de historial pueden caber. El costo crece con ello, porque todo el historial se envía cada vez. Aquí tienes un ejemplo práctico para una sesión larga.

Supongamos que el historial ha crecido a 30.000 tokens y la respuesta es de 300 tokens. Entrada: 30.000 x $0,15 / 1M = $0,0045. Salida: 300 x $0,50 / 1M = $0,00015. Una sola respuesta cuesta $0,00465. Cien respuestas a ese tamaño suman $0,465, es decir, aproximadamente 47 centavos.

Un historial más corto es más barato y a menudo mejor. Los modelos prestan menos atención al medio de prompts muy largos, por lo que un resumen limpio de eventos antiguos más las últimas doce mensajes pueden leerse de forma más consistente que 30.000 tokens en bruto. Muchas interfaces tienen una función de resumen o "memoria". Úsala una vez que el chat supere unos pocos miles de tokens.

Los precios son $0,15 por 1M de entrada y $0,50 por 1M de salida. Las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. Consulta la página de precios para montos de recarga, bonificaciones y métodos de pago, incluyendo tarjeta y cripto.

Mantener la consistencia de un personaje durante semanas

Los personajes de larga data se desvían. La solución es principalmente gestión, y cuesta muy pocos tokens si se hace bien.

Mantén un bloque fijo de hechos que nunca cambie: nombre, personalidad, hábitos de habla, relaciones. Mantén un segundo bloque que actualices manualmente de vez en cuando: la situación actual, hilos de trama abiertos, promesas hechas. Pega ambos en el prompt del sistema o el campo de memoria de tu cliente, y mantén cada uno por debajo de unos 500 tokens. Juntos son como máximo 1.000 tokens, que cuestan $0.00015 por respuesta a la tasa de entrada.

Luego permite que el chat en vivo lleve solo el intercambio reciente. Cuando termine una escena, escribe dos o tres frases de resumen en el segundo bloque y borra los mensajes antiguos. Tus personajes se mantienen nítidos, las respuestas son más rápidas de leer y el costo por respuesta se mantiene cerca de un décimo de centavo en lugar de subir con cada sesión.

Si ejecutas varios personajes en un chat, di quién habla y cuándo. Una línea como "Solo escribe las líneas de Mara a menos que el usuario pida otro personaje" evita que el modelo narre a todos a la vez, lo que también mantiene las respuestas cortas y baratas.

Solución de problemas con 429 y respuestas extrañas

Las aplicaciones de roleplay son propensas a activar accidentalmente los límites de velocidad: dos pestañas del navegador, un botón de "regenerar" pulsado dos veces, un chat grupal donde varios personajes responden a la vez. La API responde con HTTP 429 y una de estas causas.

  1. Código de error concurrency. Tienes más peticiones en curso de las que permite tu clave. Cierra pestañas adicionales, espera a que termine el streaming o desactiva las respuestas simultáneas de personajes. Recuerda que un streaming ocupa su espacio hasta que termina.
  2. Código de error rate_limited. Enviaste demasiadas solicitudes en un minuto. Ralentiza; una persona que escribe rara vez alcanza las 300 por minuto, pero un bucle automático puede llegar a 60 con una clave de prueba.
  3. 429 con un encabezado Retry-After: 5. El servicio está temporalmente sobrecargado. Espera cinco segundos y vuelve a enviar.

Si las respuestas se cortan, comprueba tu configuración de max_tokens en el cliente. Si el personaje habla por ti, refuerza la regla en el prompt del sistema y reduce la temperatura. Si la aplicación indica que el modelo no se encuentra, asegúrate de que el campo del modelo sea exactamente uncensored, en minúsculas.

Dónde encaja y dónde no

Funciona como un reemplazo listo para usar cuando tu cliente te permite elegir tu propio endpoint y quieres un único modelo con un precio por token fijo. No reemplaza a un enrutador si te gusta cambiar entre varios modelos durante el chat. Obtienes un modelo, de un proveedor independiente, no la API oficial de ningún proveedor de modelos.

El modelo es solo de texto. No generará arte de personajes, voz ni video, y los embeddings no están disponibles. Cualquier cosa en tu cliente que dependa de eso necesita otro servicio. Los prompts no se usan para entrenamiento, y el inicio rápido completo está en la docs.

Preguntas y respuestas

¿Qué nombre de modelo escribo en la configuración estilo Janitor AI?

Escribe uncensored, en minúsculas, en el campo del modelo. Usa https://api.openrouterapi.cc/v1 como URL y tu propia clave.

¿Por qué obtengo un error 429 a mitad del chat?

O bien hay demasiadas peticiones abiertas a la vez (concurrencia) o demasiadas por minuto (limitado por tasa). Cierra pestañas adicionales y espera a que terminen las transmisiones; una clave de prueba permite 2 a la vez.

¿Puede el modelo crear imágenes para mis personajes?

No. Es un modelo solo de texto, sin generación de imágenes, audio ni video.

¿Cuánto cuesta una sesión de roleplay?

Con un historial de 30.000 tokens y respuestas de 300 tokens, cada respuesta cuesta aproximadamente $0.0047, por lo que 100 respuestas cuestan unos 47 centavos.

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