OpenRouter Heretic: Guía Completa de Integración

Por qué elegir OpenRouter Heretic?

Proporciona un único modelo potente y sin censura, sin la complejidad del enrutamiento entre múltiples modelos. Los desarrolladores a menudo luchan con ecosistemas de API fragmentados que cobran tarifas distintas para diferentes modelos. Esta configuración ofrece un punto de conexión unificado para la generación de texto sin procesar. Obtienes un comportamiento consistente en todas las solicitudes. El modelo está ajustado para contenido adulto lícito y temas controvertidos sin rechazos innecesarios. No es GPT, Claude ni Gemini. Es un modelo de pesos abiertos que se ejecuta en servidores dedicados. Esto significa latencia predecible y precios claros. Solo pagas por los tokens utilizados. Los errores no te cuestan créditos. El modelo prepagado garantiza que nunca pierdas el acceso a mitad de proyecto. Sin cuotas mensuales que te aten. Conservas tus créditos para siempre. Esta simplicidad ahorra tiempo de ingeniería. Te concentras en crear funciones. No en gestionar las peculiaridades de los proveedores. La ventana de contexto de 100k maneja documentos grandes de manera eficiente. Los sistemas RAG se benefician enormemente de esta capacidad. La indexación de archivos Epstein o el análisis de documentos legales funcionan bien. El modelo entiende los matices. No sanitiza las respuestas por razones puritanas. Te da los datos que necesitas. Directamente. Sin recargos de intermediarios. Solo texto de entrada, texto de salida. Fiable. Rápido. Sin censura.

Prerrequisitos: configuración de la cuenta

Necesitas una dirección de correo electrónico y una billetera de criptomonedas para recargas. El registro es instantáneo a través de Google o correo electrónico. La verificación del número de teléfono no bloquea tu progreso. Recibes una clave API de inmediato. La clave está activa para 100 solicitudes por minuto. Puedes ejecutar 8 solicitudes concurrentes. El límite del cuerpo de la solicitud es de 8 MB. Esto maneja la mayoría de las tareas estándar de LLM. Obtienes un crédito de prueba de $0.50 durante siete días. Esto te permite probar el endpoint. Úsalo para verificar la transmisión. Comprueba la llamada de herramientas. Valida el modo JSON. Una vez que estés satisfecho, recarga con criptomonedas. Se aceptan USDT en TRC20 o USDC en Base. La recarga mínima es de $20. La máxima es de $500. Obtienes créditos de bonificación en niveles superiores. $50 obtiene un bono del 5%. $100 obtiene un 10%. $200 obtiene un 15%. Los créditos nunca expiran. Puedes pausar el uso durante meses. Luego reanudar. Tu saldo permanece intacto. No aparecen tarifas ocultas. No se emiten reembolsos para el uso estándar. Los errores se manejan a través de soporte. La privacidad es sencilla. Los prompts no se utilizan para el entrenamiento. Tus datos permanecen tuyos. Esta configuración es adecuada para desarrolladores que desean control. Sin bloqueo de proveedor. Solo una API limpia.

Paso 1: Genera tu clave API

Visita el panel de control y haz clic en 'Obtener clave API'. La interfaz es mínima. Introduce tu correo electrónico o usa el inicio de sesión con Google. El sistema genera una clave única. Parece una larga cadena de caracteres. Cópiala inmediatamente. Guárdala en tus variables de entorno. No la subas a repositorios públicos. La clave está vinculada a tu cuenta. Solo puedes tener una clave activa. Si generas una nueva, la anterior dejará de funcionar. Esto simplifica la seguridad. No gestionas múltiples claves. Rotarlas cuando sea necesario. La clave otorga acceso al endpoint de chat-completions. También permite leer metadatos del modelo. No puedes usarla para embeddings. Ni para generación de imágenes. El alcance está claro. Texto de entrada, texto de salida. La clave autentica tus solicitudes. El servidor verifica tu saldo. Deduce los tokens utilizados. Los errores son gratuitos. Si el servidor devuelve un error 500, no pierdes créditos. Esto protege tu presupuesto. Puedes generar claves para diferentes entornos. Dev y Prod usan claves separadas. Esto evita gastos accidentales. La interfaz muestra tu saldo actual. Se actualiza en tiempo real. Puedes ver el uso de tokens. Te ayuda a prever costes. El sistema es transparente. Sin sorpresas. Solo facturación precisa. La confianza se construye mediante la claridad.

Paso 2: Configura tu cliente

Apunta tu SDK a la URL base: HTTPS://api.llmheretic.com/v1. Esta URL es compatible con las bibliotecas oficiales de OpenAI. Cambias la URL base en tu configuración. Luego estableces el encabezado de clave API. El ID del modelo es 'uncensored'. Este es el único modelo disponible. No eliges entre GPT-4 o Llama. Usas este. Está ajustado para salida sin censura. Configuras tu temperatura. Estableces top_p. Defines secuencias de parada. Estos parámetros controlan la creatividad. Temperatura baja hace que las salidas sean deterministas. Temperatura alta añade aleatoriedad. Ajusta según tu caso de uso. Para generación de código, usa valores bajos. Para escritura creativa, súbelos. La opción de streaming está disponible. Establece stream a true para entrega de tokens en tiempo real. Esto mejora la experiencia del usuario. Los usuarios ven el texto a medida que se genera. Reduce la latencia percibida. El modo JSON es útil para datos estructurados. Establece response_format a json_object. El modelo devuelve JSON válido. Esto se integra bien con aplicaciones frontend. Se admiten herramientas y llamada de funciones. Define el esquema de tu función. El modelo llama a las funciones correctamente. Esto habilita flujos de trabajo agénticos. Puedes construir sistemas complejos. La configuración es estándar. Sin peculiaridades propietarias. Reutilizas código existente. La migración es sencilla. El SDK maneja la serialización. Te enfocas en la lógica. No en detalles del protocolo.

Paso 3: Envía tu primera solicitud

Construye una solicitud POST a /v1/chat/completions. Incluye tu clave API en el encabezado. Establece el modelo en 'uncensored'. Pasa un array de mensajes. Cada mensaje tiene un role y content. Usa 'user' para la entrada. 'assistant' para turnos anteriores. 'system' para instrucciones. El prompt del sistema guía el comportamiento. Establécelo para definir el tono. O restringe el formato de salida. El cuerpo de la solicitud incluye el prompt. Los tokens se cuentan automáticamente. La entrada cuesta $0.15 por millón de tokens. La salida cuesta $0.50 por millón de tokens. Estas tarifas son transparentes. Ves el recuento de tokens en la respuesta. El último fragmento contiene datos de uso. Esto te ayuda a rastrear los costos. Los errores son gratuitos. Si el modelo falla, no pagas nada. Esto reduce el riesgo. Puedes experimentar libremente. La ventana de contexto de 100k permite entradas grandes. Pega documentos completos. Incluye el historial de conversaciones. El modelo retiene el contexto. Responde con precisión. La transmisión es opcional. Si la desactivas, esperas a la respuesta completa. Esto es más simple para trabajos por lotes. Elige según tus necesidades. El límite de tamaño de la solicitud es de 8 MB. Esto se ajusta a la mayoría de los casos de uso. Las cargas útiles más grandes pueden necesitar fragmentación. La API maneja la validación. Devuelve mensajes de error claros. Puedes depurar rápidamente. El proceso es sencillo. Sin pasos de configuración complejos. Solo envía la solicitud. Obtén el resultado. Construye tu aplicación.

Paso 4: Maneja las respuestas en streaming

Habilita el streaming estableciendo stream en true. El servidor envía una serie de fragmentos. Cada fragmento contiene un token parcial. Acumulas estos tokens. Muéstralos al usuario en tiempo real. Esto crea un efecto de escritura. Los usuarios perciben un rendimiento más rápido. El último fragmento incluye datos de uso. Contiene los recuentos de tokens. Puedes registrarlos para la facturación. El stream termina con un marcador de finalización. Maneja los errores de forma elegante. Las interrupciones de red pueden romper el stream. Se recomienda lógica de reintento. El formato SSE es estándar. Analiza el campo de datos. Extrae el texto. Ignora los fragmentos de metadatos. Concéntrate en el contenido. Esto funciona con cualquier cliente HTTP. Node.js, Python, Go y Rust lo admiten. El SDK analiza automáticamente. Obtienes un objeto de stream. Itera sobre él. Envía tokens a tu interfaz de usuario. Esto es ideal para interfaces de chat. Los usuarios ven las respuestas a medida que se generan. Reduce el tiempo de espera. Se aplica el límite máximo de salida de 16k. Si necesitas algo más largo, realiza múltiples solicitudes. Concatena los resultados. El modelo mantiene la coherencia. Entiende el contexto. El streaming no afecta a la calidad. Solo cambia la velocidad de entrega. Úsalo para aplicaciones interactivas. Desactívalo para el procesamiento por lotes. Ahorras ciclos de CPU. La elección es tuya. La flexibilidad es clave. Construye lo que mejor funcione para tus usuarios.

Paso 5: Monitorear uso y costos

Verifica tu saldo en el panel de control. Se actualiza en tiempo real. Ves el uso de tokens por solicitud. El último fragmento de streaming muestra el uso. Registra estos datos en tu sistema. Rastrea los tokens de entrada frente a los de salida. La salida es más cara. Optimiza tus prompts para reducir la longitud de entrada. Usa los prompts del sistema de manera eficiente. Evita repetir contexto. El modelo prepagado significa que controlas tus gastos. Recarga cuando el saldo sea bajo. Las recargas con criptomonedas son instantáneas. Se admiten USDT y USDC. Los créditos bonificados añaden valor. $100 dan un 10% extra. Esto reduce tu coste efectivo. Los créditos no caducan. Puedes ahorrar para picos de uso. Sin cuotas mensuales. Sin trampas de renovación automática. Si se te cobra dos veces, contacta con soporte. Lo arreglan manualmente. Los reembolsos no son estándar. Los créditos son definitivos. Esto fomenta un gasto cuidadoso. Monitorea el uso de tu clave API. El límite es de 300 solicitudes por minuto. El máximo de solicitudes concurrentes es 8. Superar los límites devuelve errores 429. Limita la tasa de tu cliente. Implementa retroceso exponencial. Esto evita el estrangulamiento. El panel de control muestra datos históricos. Analiza tendencias. Identifica picos. Ajusta tu arquitectura. La optimización de costes es continua. Los pequeños cambios suman. La eficiencia importa. Cada token cuenta. Tu presupuesto es tuyo para gestionar.

Paso 6: Configuraciones avanzadas (Herramientas, JSON)

Usa la llamada a funciones para flujos de trabajo agénticos. Define las herramientas en la solicitud. Especifica nombre, descripción y parámetros. El modelo decide qué herramienta llamar. Devuelve los argumentos. Ejecutas la función. Pasas los resultados de vuelta al modelo. Genera una respuesta final. Esto permite lógica compleja. Búsqueda en la web. Consultas a bases de datos. Ejecución de código. El modo JSON garantiza una salida estructurada. Establece response_format a json_object. El modelo devuelve JSON válido. Analízalo en tu código. Esto es crucial para las APIs. Evita errores de análisis. El esquema es flexible. Tú defines la estructura. El modelo la sigue. La temperatura afecta la elección de herramientas. Valores más bajos hacen que las decisiones sean deterministas. Valores más altos añaden variedad. Usa una temperatura baja para mayor fiabilidad. Top_p filtra el muestreo de núcleo. Ajústalo para la diversidad. Las secuencias de parada detienen la generación. Útiles para texto estructurado. Seed asegura la reproducibilidad. Establece una semilla para depurar. Los resultados son consistentes. Estas características amplían la API. Construyes agentes potentes. El modelo entiende las instrucciones. Ejecuta tareas con precisión. No alucina con los nombres de las herramientas. Se adhiere a tu esquema. Esta fiabilidad es clave. Para sistemas en producción. Necesitas predictibilidad. Esta configuración la proporciona. Combínalas para máxima utilidad. Construye aplicaciones inteligentes. Resuelve problemas reales. El modelo uncensored maneja prompts complejos. No rechaza herramientas válidas. Las ejecuta por completo. Impulsa tu próximo proyecto.

Solución de errores comunes

Los errores 429 significan límite de velocidad excedido. Enviaste demasiadas solicitudes. Espera y reintenta con retroceso. Los errores 401 indican una clave API inválida. Revisa tu clave. Asegúrate de que esté activa. Regenera si se perdió. Los errores 400 son solicitudes incorrectas. Revisa la sintaxis JSON. Verifica que el ID del modelo sea 'uncensored'. Asegúrate de que el array messages sea correcto. El rol debe ser 'user', 'assistant' o 'system'. El contenido debe estar presente. Los errores 500 son problemas del servidor. Reintenta una vez. Si persiste, contacta a soporte. Los errores son gratuitos. No pierdes créditos. Esto es seguro para pruebas. Revisa tu saldo. Si es cero, recarga. Los pagos con criptomonedas son instantáneos. USDT en TRC20. USDC en Base. Verifica la red. Las conexiones lentas pueden agotar el tiempo de espera. Aumenta los valores de tiempo de espera. Las salidas grandes pueden alcanzar el límite de 16k. Divide tu solicitud. O acepta una salida parcial. El streaming maneja esto bien. Muestra lo que obtienes. El modelo continúa. La ventana de contexto es de 100k tokens. Si la excedes, el modelo trunca. Elimina mensajes antiguos. Mantén el contexto reciente. Esto mejora la relevancia. Depura sistemáticamente. Registra entradas y salidas. Compara con los resultados esperados. Aísla el problema. La API es robusta. Los errores son raros. Cuando ocurren, son claros. Corrígelos rápidamente. Sigue construyendo.