usando la base_url incorrecta
Usar la URL base estándar de OpenAI hace que tus solicitudes fallen o se enruten a un modelo diferente por completo. Nuestra API requiere que cambies la base_url para https://api.whatisopenrouterai.com/v1. Esta única línea de configuración asegura que tu SDK se conecte a nuestros servidores en lugar de la infraestructura global de OpenAI.
Muchos desarrolladores copian y pegan su código existente sin actualizar esta variable. Si dejas la URL predeterminada, obtendrás un error 404 o alcanzarás un modelo que no está sin censura. Verifica siempre la conexión revisando la /v1/models endpoint. Deberías ver nuestro ID de modelo específico listado allí. Esto confirma que el enrutamiento es correcto antes de enviar tu primera solicitud de finalización.
olvidando establecer el id del modelo
Incluso con la URL base correcta, omitir el ID del modelo devuelve un modelo genérico o más antiguo. Debes establecer explícitamente el model el parámetro a "uncensored" en cada solicitud. Esto le indica a nuestra capa de enrutamiento que sirva el modelo específico de peso abierto ajustado para contenido sin restricciones.
Sin esta instrucción explícita, podrías recibir un modelo diferente con reglas de alineación distintas. Algunos modelos rechazan temas adultos lícitos por defecto. Al forzar el uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
ignorando los límites de tokens y errores
Superar la ventana de contexto de 100,000 tokens o el límite de salida de 16,000 tokens provoca fallos inmediatos de solicitud. Nuestra API aplica un máximo de salida de 16,000 tokens por solicitud. Si no configuras max_tokens, el valor predeterminado es solo 2,048 tokens. Esto suele ser demasiado corto para tareas de razonamiento complejo.
Los errores y rechazos no consumen tu crédito prepagado. Sin embargo, las solicitudes malformadas que alcanzan los límites de velocidad o exceden el tamaño del cuerpo (8 MB) aún cuentan contra tu cuota. Monitorea los encabezados de respuesta para el uso de tokens. Ajusta tu ingeniería de prompts para ajustarse a la ventana de contexto. Esto evita reintentos costosos y asegura un flujo de datos fluido.
malentendido sobre la facturación prepagada
El saldo de tu cuenta está vinculado a un crédito prepagado, no a una suscripción mensual. Cobramos $0.15 por cada 1M de tokens de entrada y $0.50 por cada 1M de tokens de salida. Los errores son gratuitos, pero las completaciones exitosas consumen crédito. Debes recargar a través de cripto para mantener la disponibilidad del servicio.
Aceptamos USDT (TRC20) o USDC (Base) para recargas. Los depósitos mínimos comienzan en $20. Las bonificaciones se aplican en niveles superiores: +5% desde $50, +10% desde $100 y +15% desde $200. El crédito nunca caduca. Asegúrate de tener un saldo positivo antes de ejecutar lotes grandes. Consulta el panel para verificar tu saldo actual y las transacciones recientes.
confundir el streaming con respuestas estándar
El streaming mediante SSE cambia la forma en que analizas el flujo de respuesta. Las respuestas estándar devuelven un único objeto JSON. El streaming devuelve múltiples fragmentos. Debes manejar el fragmento final para obtener estadísticas precisas de uso de tokens.
Nuestra implementación de streaming incluye el uso de tokens en el último fragmento. Si detienes la lectura del flujo antes de tiempo, podrías perder estos datos. Asegúrate de que tu biblioteca cliente soporte SSE correctamente. Esto es crucial para aplicaciones en tiempo real donde se muestran los tokens a medida que se generan. Un streaming mal configurado puede provocar texto incompleto o estados de interfaz de usuario rotos.
errores de configuración de tool_choice
Incorrecto tool_choice ajustes pueden impedir que la llamada de funciones funcione como se espera. Puedes forzar una herramienta específica o dejar que el modelo decida. Una mala configuración suele hacer que el modelo ignore las funciones disponibles.
Usar tool_choice para controlar si el modelo llama a las herramientas automáticamente. Establécelo en "auto" para flexibilidad o especifica un ID de herramienta para un comportamiento estricto. Asegúrate de que tus definiciones de funciones coincidan con el esquema esperado. Esto evita errores en tiempo de ejecución cuando el modelo intenta llamar a una función que no existe. Prueba tus definiciones de herramientas a fondo antes de implementarlas en producción.
falta el modo json_object
Sin response_format: {"type": "json_object"}, el modelo puede generar markdown o texto sin formato. Esto rompe los analizadores que esperan JSON estricto. Habilita el modo JSON para garantizar una salida consistente y analizable.
Esta característica es esencial para la integración con sistemas posteriores que requieren datos estructurados. Reduce significativamente la sobrecarga de postprocesamiento. Valida siempre el esquema de salida en el código del cliente. Esto garantiza robustez frente a alucinaciones ocasionales del modelo. Usa este modo al extraer entidades o generar archivos de configuración.
sorpresas con los límites de tasa
Nuestra API permite 300 solicitudes por minuto por clave. Exceder este límite resulta en una respuesta 429 Too Many Errors. Las solicitudes concurrentes están limitadas a 8 por clave. Planifica tu configuración de concurrencia en consecuencia.
Si ejecutas múltiples procesos, asegúrate de que compartan la misma clave o genera claves separadas. Cada cuenta admite una clave activa. Una nueva clave reemplaza a la anterior. Supervisa las cabeceras de límite de tasa en la respuesta. Implementa una retroexponencial en tu lógica de reintento. Esto evita fallos en cascada durante períodos de alto tráfico.
retrasos en la recarga de cripto
Las transacciones con criptomonedas pueden tardar en confirmarse en la blockchain. Tu crédito puede no aparecer inmediatamente después de enviar fondos. Utiliza la red correcta: TRC20 para USDT o Base para USDC. Enviar a la red incorrecta provoca la pérdida de fondos.
Las recargas van desde $20 hasta $500. Asegúrate de enviar la cantidad exacta o considera las tarifas de red. Verifica el hash de la transacción en el explorador de bloques. Si el crédito se retrasa, contacta a soporte con el ID de la transacción. No asumas que el pago falló inmediatamente. La paciencia durante la congestión de la red es clave para un funcionamiento fluido.
