Guía de integración de la API de OpenRouter

¿Por qué cambiar tu punto de conexión de API de OpenRouter?

Muchos desarrolladores encuentran límites de velocidad o filtros de contenido al usar las versiones gratuitas de modelos populares sin censura. Podrías ver errores como "no endpoints found" o una reducción repuesta de velocidad durante las horas pico. Nuestro servicio aísla el modelo Dolphin en servidores dedicados para garantizar una alta disponibilidad. Esto elimina la variabilidad de la infraestructura de enrutamiento compartida. Obtienes acceso directo a un único modelo potente sin interferencia de datos de entrenamiento. La API permanece completamente compatible con OpenAI, lo que significa que tu código de cliente existente funciona con cambios estructurales cero. Este enfoque garantiza una latencia predecible para roleplay o generación de texto sin restricciones. Evitas la frustración de los problemas de enrutamiento de modelos que plagam a los agregadores de múltiples modelos.

Paso 1: Obtén tu clave API sin censura

Puedes generar tu clave de API inmediatamente registrándote con tu correo electrónico o cuenta de Google. No se requiere verificación de número de teléfono para este proceso. Una vez registrado, tu clave se muestra al instante en el panel de control. Cada cuenta está limitada a una clave activa para garantizar un seguimiento seguro. Si necesitas una clave nueva, la antigua se reemplaza inmediatamente. Este proceso de registro simplificado te permite comenzar a probar tu integración en cuestión de minutos. La clave otorga acceso al modelo sin censura sin cuotas de suscripción. Solo pagas por los tokens que realmente consumes.

Paso 2: Actualiza tu URL base

Para migrar tu aplicación, debes actualizar la URL base en la configuración de tu cliente compatible con OpenAI. Apunta tu SDK a nuestro punto de conexión dedicado en https://api.openrouterdolphinai.com/v1. Esta URL funciona con cualquier implementación de SDK estándar de OpenAI. No necesitas cambiar tu ID de modelo; usa uncensored como el identificador del modelo. Este simple cambio dirige tus solicitudes a nuestros servidores aislados. Asegura que tu tráfico no se mezcle con el de otros usuarios de agregadores compartidos. El endpoint soporta flujos de trabajo de chat-completions estándar sin requerir nuevos encabezados de autenticación.

Paso 3: Prueba con el endpoint /v1/chat/completions

Verifica tu lógica de integración enviando una solicitud POST estándar al endpoint de chat-completions. Nuestra API admite una ventana de contexto de 100.000 tokens para prompt y finalización combinados. Puedes generar hasta 16.000 tokens por solicitud si especificas max_tokens. El límite de salida predeterminado es de 2,048 tokens si omites este parámetro. El endpoint acepta parámetros estándar como temperature, top_p, y stop. Esto asegura compatibilidad con las instrucciones del sistema y los prompts existentes. También puedes activar el modo JSON mediante response_format para salidas de datos estructurados. Probar con un prompt de texto simple confirma que tu configuración es correcta.

Paso 4: Habilita el streaming para salida en tiempo real

Las respuestas en streaming son esenciales para una experiencia de usuario fluida en aplicaciones de roleplay. Nuestra API admite Server-Sent Events (SSE) para la entrega token por token. Debes configurar stream el parámetro a true en tu solicitud. El último fragmento del flujo incluye el uso total de tokens para la solicitud. Esto te permite rastrear los costos en tiempo real sin llamadas adicionales a la API. La transmisión reduce la latencia percibida entregando contenido tan pronto como se genera. Esta función es crítica para mantener la participación en conversaciones dinámicas. Configura tu cliente para manejar flujos SSE de manera eficiente.

Paso 5: Configura las llamadas de funciones

Nuestra API admite llamada a funciones con el formato estándar de herramientas de OpenAI. Puedes definir herramientas y especificar tool_choice para ejecución automática o específica. Esto habilita flujos de trabajo complejos donde el modelo decide qué función invocar. La API maneja el análisis de entrada de herramientas y el formato de salida de manera confiable. Puedes usar esto para extracción de datos estructurados o acciones automatizadas. La llamada de funciones funciona sin problemas con las capacidades del modelo sin censura. Esto hace que nuestra API sea adecuada para arquitecturas de agentes avanzadas que requieren integración de herramientas externas. Asegúrate de que las definiciones de tus herramientas sigan el formato estándar de esquema JSON.

Gestión de límites de velocidad y errores

Está limitado a 300 solicitudes por minuto por clave de API. Esto permite un alto rendimiento manteniendo la estabilidad del servidor. Puede tener hasta 8 solicitudes concurrentes activas simultáneamente. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Si excede estos límites, recibirá un error estándar de límite de tasa. Nuestra tarifa es transparente: $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida. Los errores y las denegaciones no generan cargos. El crédito nunca expira, por lo que puede recargar cuando le convenga. Este modelo de pago por uso asegura que solo pague por el uso real.

Por qué esta alternativa a la API de OpenRouter es mejor para NSFW

Muchos agregadores aplican filtros de contenido o enrutan solicitudes a través de modelos con niveles variables de sin censura. Nuestro servicio sirve un único modelo Dolphin dedicado ajustado para la generación sin restricciones. No rechaza temas adultos, ficticios o controversiales legales. El único límite estricto es el contenido que involucra a menores. Esta consistencia es crucial para aplicaciones de juego de roles y escritura creativa. Evitas la imprevisibilidad de los enrutadores multi-modelo que pueden cambiar de modelo a mitad de sesión. La infraestructura dedicada asegura que las preferencias de contenido se mantengan consistentemente en todas las solicitudes.

Lista de verificación final para una migración fluida

Antes de ir a producción, verifica que tu URL base apunte a nuestro endpoint dedicado. Asegúrate de que tu clave API esté activa y tenga el formato correcto. Prueba tanto las respuestas de streaming como las no streaming para confirmar la estabilidad. Verifica que las herramientas de llamada de funciones estén definidas correctamente. Confirma que el seguimiento del uso de tokens se alinea con el último fragmento SSE. Confirma que tu método de pago está configurado para recargas con criptomonedas. Nuestra API acepta USDT en TRC20 o USDC en Base. Comienza con el crédito de prueba para validar tu flujo de trabajo antes de comprometerte con compras más grandes. Esta lista de verificación asegura una transición fluida desde tu proveedor anterior.