Integración paso a paso de la API LLM uncensored.com

Prerrequisitos: SDK y configuración del entorno

Instala el SDK del lenguaje preferido para comunicarte con el endpoint. La mayoría de los desarrolladores usan el SDK oficial de OpenAI para Python, Node.js o Go. Esto funciona porque la API sigue el esquema estándar de chat completions de OpenAI.

Asegúrate de que tu entorno tenga Python 3.8+ o Node.js 18+. Instala el paquete mediante pip o npm. Necesitarás una clave API desde el panel de control. No se requiere número de teléfono para el registro.

• Python: pip install openai
• Node.js: npm install openai

Guarda tu clave API en una variable de entorno. Esto evita su exposición accidental en el control de versiones. La clave otorga acceso al modelo sin censura.

Configurando la URL base

Apunta tu cliente SDK a la URL base correcta. Este es el paso más crítico para una integración exitosa. La URL base predeterminada de OpenAI no funcionará para este servicio.

Establece la URL base en HTTPS://api.uncensoredaicom.com/v1. Esto dirige las solicitudes a la infraestructura de LLM uncensored. El ID del modelo que debes enviar es "uncensored". Es un modelo de peso abierto ajustado para minimizar las negativas.

Verifica la conexión llamando al endpoint de modelos. Esto confirma que tus credenciales y la URL base son correctas. Una respuesta exitosa devuelve el ID del modelo y el tipo de objeto.

Configuración de autenticación y encabezados

Pasa tu clave de API en el encabezado Authorization. Usa el esquema Bearer para todas las solicitudes. Este encabezado autentica tu cuenta de crédito prepagado.

Establece el encabezado como: Authorization: Bearer YOUR_API_KEY. El SDK maneja esto automáticamente si pasas la clave al constructor del cliente. Asegúrate de que no haya espacios en blanco adicionales. Las claves inválidas devuelven un error 401 Unauthorized.

Obtienes una clave activa por cuenta. Generar una nueva clave invalida la anterior. Esto simplifica la rotación de claves y la gestión de seguridad. Mantén tu clave segura en tu entorno de implementación.

Enviar una Solicitud Estándar de Chat

Realiza una solicitud POST a /v1/chat/completions. Envía tus mensajes como un array de objetos con role y content. El sistema soporta los roles user, assistant y system.

Estructura de ejemplo: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. La API devuelve una finalización de texto. La ventana de contexto es de 100,000 tokens en total. La salida máxima es de 16,000 tokens por solicitud.

Los errores y rechazos no consumen crédito. Esto protege tu saldo prepagado. Configura temperature y top_p para tener control. Los valores predeterminados funcionan para la mayoría de los casos de uso.

Habilitando Streaming para Salida en Tiempo Real

Establecer stream: true en tu cuerpo de solicitud. Esto activa Eventos Enviados por Servidor (SSE). Los tokens llegan de forma incremental en lugar de esperar a la finalización completa.

Analiza el flujo SSE para mostrar el texto en tiempo real. El fragmento final contiene las estadísticas de uso de tokens. Esto permite un seguimiento preciso de la facturación. La transmisión reduce la latencia percibida para los usuarios finales.

Maneja interrupciones de red de forma elegante. Reconecta si la transmisión se cae. La API uncensored admite transmisión estable. Monitorea el estado de la conexión. Úsalo para interfaces de chat o generación de texto largo.

Usando Herramientas y Llamada de Función

Define las herramientas en el cuerpo de la solicitud. Pasa una lista de esquemas de función. El modelo puede invocar estas funciones según la intención del usuario. Esto habilita un comportamiento similar al de un agente.

Especificar tool_choice para controlar la selección de funciones. Usa auto para detección automática. La API admite definiciones de herramientas estándar. Analiza los argumentos de la llamada a la función desde la respuesta.

Implementa la ejecución de la función en tu código. Envía el resultado de vuelta como un mensaje. El modelo continúa la conversación. Esto habilita flujos de trabajo complejos. Las pruebas aseguran un análisis preciso de argumentos.

Manejo de respuestas en modo JSON

Establecer response_format: {"type": "json_object"}. Esto obliga al modelo a generar JSON válido. Úsalo para la extracción de datos estructurados. Evita errores de respuestas mal formadas.

Analiza la cadena JSON en tu código. Maneja los posibles errores de análisis. El modo JSON mejora la fiabilidad para las integraciones de API. Es ideal para pipelines de procesamiento de datos.

Combina el modo JSON con prompts del sistema. Guía al modelo para que genere esquemas específicos. Esto asegura un formato consistente. Valida la salida antes de usarla. Esto reduce errores en procesos posteriores.

Límites y errores de monitoreo

Respeta los límites de velocidad. Tienes derecho a 300 solicitudes por minuto por clave. Máximo 8 solicitudes concurrentes. El tamaño del cuerpo de la solicitud está limitado a 8 MB.

Monitoriza los códigos de estado HTTP. 429 indica límite de velocidad excedido. 400 indica solicitud incorrecta. 500 indica error del servidor. Implementa retroceso exponencial para reintentos. Esto evita sobrecargar la API.

Rastrea el uso de tokens en el último fragmento del streaming. Esto ayuda a gestionar tu crédito prepagado. Los errores no consumen tokens. Esto protege tu saldo. La monitorización periódica garantiza un funcionamiento fluido.

Cálculo de costos y uso de tokens

La facturación es transparente y prepagada. Los tokens de entrada cuestan $0.15 por millón. Los tokens de salida cuestan $0.50 por millón. El crédito nunca vence. No se aplican cuotas mensuales.

Recarga solo con criptomonedas. USDT (TRC20) o USDC (Base). Las cantidades van desde $20 hasta $500. El crédito bonificado aplica para recargas mayores. +5% desde $50, +10% desde $100, +15% desde $200.

Calcula los costos antes de un uso intensivo. Estima los recuentos de tokens para tus indicaciones. Esto ayuda a presupuestar eficazmente. Los errores son gratuitos. No se emiten reembolsos, pero los errores se corrigen. Utiliza el panel de control para rastrear los gastos.