El OpenRouter API Explicado
Una API compatible con OpenAI te permite cambiar tu base de código a un nuevo proveedor sin reescribir la lógica, lo cual es crítico cuando necesitas modelos sin censura para casos de uso específicos. Esta guía explica cómo funcionan las URLs base, la facturación de tokens y el streaming para que puedas integrar un endpoint alternativo de forma fiable.
Última actualización
Resumen
- Usa el endpoint estándar /v1/chat/completions con cualquier SDK de OpenAI simplemente cambiando la URL base.
- La facturación por tokens es prepagada y transparente, cobrando solo por el uso real sin suscripciones mensuales.
- Las respuestas en streaming mediante SSE permiten la entrega de tokens en tiempo real, esencial para interfaces de chat.
- Se admite la invocación de funciones y el modo JSON para la extracción de datos estructurados y la integración de herramientas.
¿Qué es una API compatible con OpenAI?
Es una API REST que sigue la interfaz de chat-completions de OpenAI. Envías prompts y recibes salidas de texto usando cargas útiles JSON estándar. Esta compatibilidad significa que tu código de cliente existente funciona sin cambios mayores.
El endpoint principal es POST /v1/chat/completions. Acepta mensajes como un array de objetos con rol y contenido. También puedes listar los modelos disponibles mediante GET /v1/models. Esta estandarización reduce significativamente el tiempo de integración.
Nuestro servicio ofrece exactamente esta interfaz. Servimos un único modelo sin censura bajo el ID "uncensored". Se ejecuta en nuestros propios servidores. No realiza enrutamiento a otros proveedores. Obtienes acceso directo al modelo que necesitas.
Las ventanas de contexto soportan hasta 100,000 tokens en total. Los límites de salida son de 16,000 tokens por solicitud. La transmisión está disponible mediante Server-Sent Events. La llamada de funciones y el modo JSON están totalmente soportados.
Comprensión de URLs base y claves API
La URL base apunta al servidor que maneja tus solicitudes. Reemplazas la URL predeterminada de OpenAI con nuestro punto de conexión específico. Nuestra URL base es HTTPS://api.openrouterabliterated.com/v1. Este cambio dirige el tráfico a nuestra infraestructura uncensored.
Las claves API autentican tus solicitudes. Generas una clave por cuenta. La clave se muestra inmediatamente después del registro. Puedes reemplazarla si es necesario. Cada cuenta tiene una clave activa a la vez.
Los límites de velocidad se aplican por clave. Puedes enviar 300 solicitudes por minuto. Hasta 8 solicitudes pueden ejecutarse simultáneamente. Los cuerpos de las solicitudes están limitados a 8 MB. Estos límites manejan bien el uso de alto volumen.
El registro requiere solo un correo electrónico o una cuenta de Google. No se necesita número de teléfono. La clave aparece al instante. Puedes comenzar a enviar solicitudes inmediatamente. Se preserva la privacidad; las solicitudes no se usan para entrenamiento.
Por qué elegir un modelo sin censura para tu caso de uso?
Los modelos sin censura no rechazan contenido adulto lícito, ficticio o controversiales. Son ideales para escritura creativa, juego de roles o investigación. Los modelos principales suelen aplicar estrictas barreras de seguridad. Estas pueden interrumpir el flujo de generación.
Nuestro modelo está ajustado para responder directamente. Maneja contenido NSFW sin resistencia. Funciona bien para filosofía política o géneros de nicho. Obtienes un comportamiento consistente sin prompts adicionales.
El uso de herramientas es compatible. Puedes definir herramientas para tu aplicación. El modelo respeta las elecciones de herramientas. Esto lo hace adecuado para flujos de trabajo complejos. Los errores y rechazos son gratuitos. Solo pagas por el uso real.
Los límites de contenido aún se aplican. El contenido sexual que involucra a menores siempre se rechaza. Este es un límite estricto. Asegura estándares básicos de seguridad. Todo lo demás es válido para tu caso de uso.
Precios de Token: Cómo se Calculan los Costes
El precio se basa en el uso de tokens. Los tokens de entrada cuestan $0.15 por 1 millón de tokens. Los tokens de salida cuestan $0.50 por 1 millón de tokens. Solo pagas por lo que usas. No hay tarifas ocultas.
El crédito es prepagado. Recargas solo con criptomonedas. Se aceptan USDT en TRC20 o USDC en Base. Se permite cualquier cantidad entera desde $20 hasta $500. Los créditos nunca caducan. Esto evita el bloqueo por suscripción.
El crédito de bonificación está disponible en las recargas. Obtienes +5% desde $50. +10% desde $100. +15% desde $200. Esto reduce tu coste efectivo. Los errores son gratuitos. Los rechazos son gratuitos. Solo pagas por los tokens exitosos.
Una cuenta de prueba recibe $0.50. Es válida por 7 días. Esto te permite probar la API a fondo. Puedes verificar la integración antes de comprometer fondos.
Respuestas de Streaming vs. No Streaming
El streaming envía tokens a medida que se generan. Esto reduce la latencia percibida. Los usuarios ven el texto aparecer en tiempo real. Es esencial para interfaces de chat. El modo sin streaming espera a la respuesta completa. Esto puede parecer lento para salidas largas.
Admitimos streaming mediante SSE. El último fragmento incluye el uso de tokens. Esto permite un seguimiento preciso de la facturación. Puedes manejar respuestas parciales de manera elegante. Los errores se manejan de forma consistente.
El modo no streaming también está disponible. Devuelve la respuesta completa de una vez. Esto es más simple para el procesamiento por lotes. Tú eliges según tus necesidades. Ambos modos usan el mismo endpoint.
La llamada a funciones puede transmitirse. Las herramientas se ejecutan a medida que se identifican. Esto mejora la interactividad. Puedes comenzar a procesar entradas antes. La API se encarga de la complejidad por ti.
Llamada de Función y Salida Estructurada
La llamada de funciones permite que el modelo invoque herramientas. Defines esquemas de herramientas en la solicitud. El modelo devuelve llamadas a funciones. Tu código las ejecuta. Esto habilita flujos de trabajo complejos. Puedes construir agentes o asistentes.
El modo JSON fuerza una salida estructurada. El modelo devuelve JSON válido. Esto es útil para la extracción de datos. Obtienes formatos consistentes. El análisis es más fácil. Los errores son raros.
Los parámetros como la temperatura y top_p controlan el comportamiento. Las secuencias de stop limitan la salida. Las semillas aseguran la reproducibilidad. Las penalizaciones reducen la repetición. Tienes un control fino.
La elección de herramientas puede ser automática o forzada. Especificas la preferencia del modelo. Esto guía el proceso de generación. Mejora la fiabilidad. Tu aplicación se mantiene robusta.
Bibliotecas cliente y SDK comunes
La mayoría de los SDK funcionan con cambios menores. Solo actualizas la URL base. El resto del código permanece igual. Esto se aplica a Python, Node.js y otros. La integración es sencilla.
El SDK de OpenAI es el estándar. Maneja la autenticación y los reintentos. Pasas tu clave API. La URL base apunta a nuestro servicio. Las solicitudes se envían normalmente.
El streaming es compatible con todos los SDKs. Iteras sobre los fragmentos. El uso de tokens está disponible en el último fragmento. Esto coincide con nuestro modelo de facturación. Los errores se capturan de manera consistente.
La llamada a funciones está integrada en los SDK modernos. Pasas las definiciones de herramientas. El SDK analiza las respuestas. Tu código ejecuta las herramientas. El bucle continúa hasta que termina. Es eficiente y fiable.
Solución de errores API comunes
Los límites de tasa devuelven errores 429. Puedes enviar 300 solicitudes por minuto. Superar esto activa una espera. Implementa retroceso exponencial. Esto evita sobrecargar el servidor.
Las claves inválidas devuelven errores 401. Comprueba tu clave API. Asegúrate de que esté activa. Reemplázala si es necesario. Cada cuenta tiene una clave. Genera una nueva si la pierdes.
Se producen errores de JSON en el modo JSON. Asegúrate de que tu esquema sea válido. El modelo debe devolver JSON válido. Si falla, reintenta. Ajusta la temperatura para una mayor estabilidad.
Los tiempos de espera se producen con generaciones largas. Aumenta tu valor de tiempo de espera. La transmisión reduce el riesgo de tiempo de espera. Se gestionan las respuestas parciales. Puedes reconstruir la salida completa.
Siguientes pasos: Obtener tu primera clave API
Visita la página de registro. Usa Google o correo electrónico. No se requiere número de teléfono. El proceso es rápido. Obtienes acceso inmediato.
Tu clave de API se muestra. Cópiala de forma segura. Úsala en tu SDK. Establece la URL base en nuestro endpoint. Comienza a enviar solicitudes.
Recarga con criptomonedas. Se aceptan USDT o USDC. Obtén crédito bonificado en importes mayores. Los créditos nunca caducan. Úsalos a tu ritmo.
Prueba con el crédito de prueba. Dura 7 días. Verifica la transmisión y la llamada de funciones. Explora las capacidades del modelo. Intégralo en tu aplicación. La API está lista para producción.
Preguntas frecuentes
¿El modelo sin censura es el mismo que los modelos de OpenRouter?
No, nuestro modelo es independiente. Se ejecuta en nuestros propios servidores. No es GPT, Claude ni ningún modelo de otro proveedor. Está ajustado para respuestas sin censura. Obtienes acceso directo sin intermediarios.
¿Cómo pago la API?
Aceptamos solo criptomonedas. Se admiten USDT en TRC20 o USDC en Base. Los depósitos van de $20 a $500. Se añade crédito de bonificación para montos mayores. Los créditos nunca caducan.
¿Puedo usar esto con el SDK de OpenAI?
Sí, es totalmente compatible. Cambia la URL base a nuestro punto de conexión. Usa el mismo método de autenticación. El resto de tu código permanece igual. El streaming y la llamada a funciones funcionan como se espera.
¿Cuáles son los límites de velocidad?
Puedes enviar 300 solicitudes por minuto. Hasta 8 solicitudes pueden ejecutarse simultáneamente. Los cuerpos de las solicitudes están limitados a 8 MB. Estos límites manejan bien el uso de alto volumen. Los errores y las negaciones son gratuitos.
Obtén tu clave de API
Regístrate, copia la clave, actualiza tu URL base. Eso es todo.
