FAQ de Uncensored API

Conceptos básicos

¿Qué es Uncensored API en una frase?

Es un endpoint de chat completations de pago y solo texto que sirve un único modelo, id uncensored, y no rechaza contenido adulto lícito, ficción o temas controvertidos.

¿Qué URL debo llamar?

Usa https://api.uncensoredapis.com/v1 como base. Las peticiones de chat van a POST /v1/chat/completions y la lista de modelos está en GET /v1/models. Cualquier otra ruta devuelve 404.

¿Tengo que aprender un nuevo SDK?

No. La forma de las peticiones y respuestas sigue la convención común de chat completions, por lo que los paquetes oficiales de Python y Node funcionan una vez que cambies la base URL y la clave. También funciona curl sin más, como muestran los docs.

¿Hay una forma de probarlo antes de pagar?

Sí. Una cuenta nueva recibe $0,50 de crédito de prueba, válido por 7 días, y no se solicitan datos de pago al registrarse. Regístrate con un correo electrónico y una contraseña en la página de claves y la clave aparecerá de inmediato.

¿Puedo elegir entre varios modelos?

No. Existe exactamente un modelo y su id es uncensored. Una llamada a la ruta de modelos devuelve esa única entrada, por lo que no hay nada que seleccionar o cambiar.

¿Para quién está pensado el servicio?

Para desarrolladores que construyen productos para adultos, incluyendo herramientas de ficción, apps de roleplay y asistentes de investigación. Tú eres responsable de tus propias verificaciones de edad y normas de contenido en lo que despliegues encima.

Claves y acceso

¿Cuántas claves recibe una cuenta?

Una. Si necesitas un nuevo valor, regénerala desde la cuenta; la clave anterior deja de funcionar al mismo tiempo, así que despliega el reemplazo de inmediato.

¿Dónde debe residir la clave?

Manténla en una variable de entorno o en un gestor de secretos en un servidor que controles. El JavaScript del navegador y los binarios móviles pueden inspeccionarse, así que enruta el tráfico del cliente a través de tu propio backend en lugar de incrustar la clave.

¿Cómo se envía la clave?

En un encabezado Authorization: Bearer en cada petición. Un valor faltante o incorrecto devuelve 401 con un objeto de error JSON.

Quiero una clave de API sin censura para un equipo. ¿Podemos compartir una?

Puedes, pero cada proceso comparte el mismo límite de 300 peticiones por minuto y el mismo saldo. Coloca una pequeña puerta de enlace delante de la clave y da a cada compañero acceso a la puerta de enlace en lugar de la clave misma.

Límites y precios

¿Qué tamaño puede tener un prompt?

La ventana de contexto es de 100.000 tokens, compartida por prompt y completion. El cuerpo de una sola petición no puede superar 8 MB. Se rechaza con un 400 una petición cuyo prompt más max_tokens exceda la ventana.

¿Qué tan larga puede ser una respuesta?

El valor predeterminado es 2048 tokens. Puedes aumentar max_tokens hasta un máximo de 32.000 por petición. Cuando una respuesta se detiene por el límite, finish_reason lee length.

¿Cuánto cuesta?

Los tokens de input cuestan $0,25 por millón y los de output $1,00 por millón. El saldo es prepago, no hay suscripción y el saldo no caduca. Consulta la página de precios para la tabla.

¿Puedes dar una estimación rápida?

Supón un turno de chat con 1.500 tokens de prompt y 300 tokens de completion, solo como ilustración. Eso es $0,000375 de input más $0,0003 de output, o aproximadamente $0,000675 por turno, así que $1 compra aproximadamente 1.480 turnos de este tipo.

¿Qué pasa cuando envío demasiadas peticiones?

Cada clave puede realizar 300 peticiones por minuto. Más allá de eso recibes un 429, y la respuesta adecuada es reducir la velocidad y reintentar con un retraso.

Preguntas de integración

¿Qué parámetros de muestreo puedo configurar?

Los parámetros estándar como temperature, top_p y stop se pasan directamente a la generación. Configúralos en el cuerpo de la petición exactamente como lo harías en otro lugar.

¿La API recuerda los turnos anteriores?

No. Cada petición es independiente, así que debes reenviar la conversación en messages cada vez. Recorta los turnos más antiguos cuando el total se acerque a la ventana de 100.000 tokens.

¿Puedo transmitir tokens a un navegador?

Sí, envía stream: true y lee los eventos enviados por el servidor. Hazlo desde tu backend y retransmite el texto a la página para que la clave nunca llegue al cliente.

¿Se admite un mensaje de sistema?

Sí. Coloca un mensaje con el rol system al principio del array para definir el tono, el formato y los límites de la conversación.

¿Qué debo comprobar primero cuando la salida parece cortada?

Lee finish_reason. Un valor de length significa que se alcanzó el límite, así que aumenta max_tokens o acorta el prompt. La referencia lista todos los valores.

Saldo y facturación

¿Cómo añado fondos?

Recarga tu saldo prepago desde tu cuenta. No hay nada que suscribirse y el saldo no utilizado permanece disponible porque no caduca.

¿Qué ocurre cuando se agota el crédito de prueba?

El crédito de prueba es válido por 7 días. Una vez gastado o expirado, las peticiones devuelven 402 con el código no_credit hasta que recargues el saldo.

¿Puedo ver cuánto costó una petición?

Cada respuesta incluye un bloque usage con los tokens del prompt, de la generación y el total. Multiplica por las tarifas por millón para obtener el cargo y lleva tu propio registro si deseas un libro mayor.

¿Son gratuitas las peticiones fallidas para reintentar?

Se permite reintentar, pero mantén el límite. Usa un backoff corto para 429 y 503 y nunca hagas bucles con 400, 401, 402 o 403, ya que no se solucionarán automáticamente. El manual de errores tiene una política lista para usar.

Contenido y comportamiento

¿Qué no hará el modelo?

No se rechaza contenido adulto lícito, ni ficción ni temas controvertidos. La excepción estricta es cualquier contenido sexual que involucre a menores, que se bloquea con un 403 cada vez, incluyendo en historias y roleplay. El servicio es para mayores de 18 años.

¿Se usan mis prompts para entrenar un modelo?

No. Los prompts no se utilizan para entrenamiento.

¿En qué se diferencia de enrutarse a través de un agregador?

Un agregador te redirige a muchos modelos, cada uno con sus propias reglas. Este servicio es un modelo bajo una sola política. La guía de OpenRouter sin censura analiza esta comparación en profundidad.

¿Puede ver imágenes o generar embeddings?

No. Solo maneja texto, sin embeddings, imágenes, audio, video ni ajuste fino.

Solución de problemas

Obtengo 402 con no_credit. ¿Qué hago ahora?

Tu saldo se ha agotado o la prueba ha caducado. Recarga el saldo prepago y envía la petición de nuevo.

Una petición devuelve 503 upstream_busy.

Es temporal. Espera unos segundos y reintenta, usando un retraso creciente y algo de aleatoriedad si ejecutas muchos trabajadores.

Mi transmisión termina y no encuentro el recuento de tokens.

Con streaming activado, se añade automáticamente un fragmento final que contiene usage, justo antes de data: [DONE]. Su lista choices está vacía, así que compruébalo antes de indexar.

¿Funcionan las herramientas y las llamadas a funciones?

Sí, en el formato estándar: pasa un array tools y busca tool_calls en la respuesta.