Comprender la URL base
La URL base define dónde tu cliente envía las solicitudes. Una discrepancia aquí provoca fallos de conexión inmediatos o respuestas de modelo inesperadas. Muchos desarrolladores asumen que la URL estándar de OpenAI funciona universalmente, pero los proveedores sin censura a menudo utilizan endpoints distintos para enrutar el tráfico a grupos de modelos específicos.
Verifique que su configuración apunte a https://api.openrouterabliteratedmodels.com/v1 para nuestro servicio. Si estás utilizando un agregador de terceros, asegúrate de que la URL base coincida exactamente con su documentación. Las URL incorrectas suelen provocar errores 404 o respuestas de modelos predeterminados en lugar de la variante sin censura prevista.
- Verifica tus variables de entorno para
BASE_URLoAPI_HOST. - Asegúrate de que la ruta incluya
/v1para compatibilidad estándar. - Prueba la conectividad con una solicitud simple de lista de modelos antes de un uso intensivo.
Gestión de límites de velocidad
Los límites de tasa restringen la cantidad de solicitudes que puedes enviar dentro de de un período de tiempo específico. Nuestra API aplica un límite de 300 solicitudes por minuto por clave. Superar este umbral genera errores HTTP 429, bloqueando temporalmente las solicitudes adicionales hasta que se restablezca el intervalo.
Además, hay un límite de solicitudes concurrentes de 8 solicitudes al mismo tiempo por clave. Si envías más de 8 solicitudes simultáneas, el exceso se pondrá en cola o fallará dependiendo de tu biblioteca cliente. Monitorea la concurrencia de tu aplicación para evitar alcanzar estos límites estrictos. Usa estrategias de retroceso exponencial en tu código para manejar los errores 429 de forma elegante sin saturar el servidor.
Recuerda que cada clave es única para tu cuenta. Compartir claves entre múltiples servicios puede acelerar el alcanzar estos límites. Genera una nueva clave si necesitas pools de límites de velocidad separados para diferentes partes de tu aplicación.
Respuestas de Streaming vs. No Streaming
El streaming devuelve datos de forma incremental a medida que se generan los tokens, mientras que sin streaming se espera a la respuesta completa. El streaming es esencial para experiencias de usuario en tiempo real, pero requiere un manejo cuidadoso de Server-Sent Events (SSE).
Al utilizar streaming, el último fragmento contiene las estadísticas de uso de tokens. Si detienes el procesamiento antes de tiempo, podrías perder estos datos. Asegúrate de que tu cliente analice el último mensaje SSE para recuperar con precisión los recuentos de tokens de entrada y salida. Las respuestas sin streaming son más simples, pero pueden causar alta latencia para salidas largas.
Elige streaming para interfaces de chat donde los usuarios ven aparecer el texto carácter por carácter. Usa no streaming para procesamiento por lotes o cuando necesites la respuesta completa antes de continuar. Nuestra API admite ambos modos a través de stream el parámetro en el cuerpo de la solicitud.
Errores del modo JSON
El modo JSON garantiza que el modelo genere JSON válido, crítico para la integración programática. Los errores aquí suelen provenir de encabezados incorrectos o incompatibilidades de esquema. La API requiere response_format: {"type": "json_object"} para forzar una salida JSON estricta.
Si recibes JSON mal formado, comprueba la definición de tu esquema. El modelo podría incluir bloques de código markdown o texto explicativo fuera de la estructura JSON. Utiliza un analizador robusto que pueda eliminar las etiquetas de markdown o validar la salida frente a tu esquema esperado. Evita esquemas demasiado complejos que puedan confundir al modelo.
Prueba primero con estructuras simples. Añade complejidad gradualmente para identificar dónde tiene dificultades el modelo. Asegúrate de que tu temperatura esté configurada apropiadamente, ya que temperaturas más altas pueden aumentar la aleatoriedad y reducir la validez del JSON.
Errores de Cálculo del Conteo de Tokens
Los conteos de tokens determinan tu facturación y el uso de la ventana de contexto. Los cálculos erróneos pueden generar cargos inesperados o respuestas truncadas. Nuestra API cobra $0.15 por cada 1M de tokens de entrada y $0.50 por cada 1M de tokens de salida.
Usa una biblioteca de tokenización fiable que coincida con el esquema de tokenización del modelo. Diferentes modelos pueden tokenizar espacios en blanco o puntuación de manera distinta, lo que lleva a discrepancias entre tu conteo local y el conteo de la API. Confía siempre en el uso de tokens devuelto en la respuesta para una facturación precisa.
Mantén un ojo en tu ventana de contexto, que es de 100.000 tokens en total. Superar este límite provocará errores. Trunca los mensajes o resúmenes más antiguos para mantenerte dentro de los límites. Monitorea el uso de tokens a lo largo del tiempo para optimizar la estructura de tus prompts y reducir costos.
Retrasos en el pago con criptomonedas
Las recargas con criptomonedas vía USDT (TRC20) o USDC (Base) se procesan al instante en nuestro lado. Sin embargo, la congestión de la red a veces puede causar pequeños retrasos en la confirmación. Asegúrate de enviar la cantidad correcta y la red adecuada para evitar pérdidas.
Las recargas oscilan entre $20 y $500 en cantidades enteras. Los créditos de bonificación se aplican automáticamente: +5% desde $50, +10% desde $100 y +15% desde $200. Verifica el hash de la transacción para confirmar el pago. Si los créditos no aparecen en unos minutos, consulta el explorador de blockchain para ver el estado de la transacción.
El crédito nunca caduca, por lo que no hay urgencia por usarlo inmediatamente. Errores como cobros dobles se resuelven a través de la página de Soporte. Guarda tus registros de transacciones para una fácil referencia si surgen problemas.
Configuración del ID del Modelo
El ID del modelo identifica qué versión del modelo sin censura estás utilizando. Para nuestro servicio, el ID del modelo es uncensored. Utilizar un ID incorrecto puede resultar en errores o comportamiento inesperado.
Asegúrate de que las solicitudes especifiquen model: "uncensored" en el cuerpo de la solicitud. Este ID apunta a nuestro modelo específico de peso abierto ajustado para respuestas sin restricciones. No es un identificador genérico sino un puntero específico a nuestra instancia alojada.
Verifica la documentación de tu biblioteca cliente para ver cómo establecer el ID del modelo. Algunas bibliotecas utilizan un model campo, mientras que otros podrían utilizar un parámetro diferente. La coherencia en el uso del ID del modelo en toda su aplicación evita confusiones y asegura que siempre esté llamando al modelo uncensored previsto.
Excedencias de la Ventana de Contexto
La ventana de contexto limita el número total de tokens que puedes enviar en una sola solicitud. Nuestra API admite una ventana de 100,000 tokens, incluyendo tanto prompt como completación. Exceder este límite genera un error.
Para gestionar el contexto, implementa una estrategia de ventana deslizante. Elimina mensajes antiguos o resúmelos para liberar espacio. Monitorea el recuento de tokens de tu entrada para asegurarte de que se mantenga dentro del límite de 100,000 tokens. Si excedes el límite, la API rechazará la solicitud.
Utiliza el max_tokens parámetro para controlar la longitud de la salida. La salida máxima por solicitud es de 16.000 tokens. Establecer este parámetro ayuda a prevenir un uso excesivo de tokens y mantiene las respuestas dentro de límites manejables para tu aplicación.
Política de soporte y reembolso
El crédito no se reembolsa una vez que se usa, pero nunca expira. Si encuentras problemas con los pagos o el servicio, contacta a Soporte a través de la página designada. Los errores como los cobros duplicados se resuelven por el equipo de Soporte.
Para problemas técnicos, consulta primero la documentación. Nuestra API es sencilla, pero pueden surgir casos límite. Proporciona tu clave API y los detalles de la solicitud al buscar ayuda. Los tiempos de respuesta varían, pero nuestro objetivo es resolver los problemas rápidamente.
Recuerda que el crédito es prepagado. Pagas por lo que consumes, siendo los errores y rechazos gratuitos. Este modelo garantiza transparencia en la facturación. Usa la página de Soporte para cualquier discrepancia o pregunta sobre tu cuenta.
