Tutorial de configuración de API compatible con OpenAI

1Elija un proveedor compatible

Seleccione un servicio que soporte el protocolo WebSocket de la Realtime API de OpenAI. Importante: Muy pocos proveedores actualmente soportan la Realtime API — la mayoría de los servicios compatibles con OpenAI solo soportan la API de Chat Completions, lo cual no es suficiente. Verifique siempre que su proveedor soporte explícitamente la Realtime API antes de continuar.

2Obtenga su endpoint API y clave

Obtenga la URL del endpoint API y la clave API de su proveedor elegido. La URL del endpoint típicamente tiene el formato https://your-provider.com o http://localhost:8080 para servicios autohospedados.

3Seleccione API compatible con OpenAI en Sokuji

Abra Sokuji y navegue al panel de Configuración. Seleccione "OpenAI Compatible API" como su proveedor de IA en el menú desplegable de proveedores.

4Ingrese su configuración

Pegue la URL de su endpoint API personalizado en el campo "API Endpoint". Ingrese su clave API en el campo "API Key". Si su proveedor no requiere una clave API (por ejemplo, servicios locales), puede dejarlo vacío o ingresar un valor de marcador de posición.

5Seleccione modelo y voz

Elija la configuración de modelo y voz que su proveedor admite. Las opciones disponibles dependen de su proveedor específico. Los modelos comunes incluyen gpt-4o-realtime-preview o nombres de modelos específicos del proveedor.

6Pruebe la conexión

Inicie una sesión de traducción para verificar que todo funciona. Haga clic en el botón Iniciar sesión, hable por el micrófono y verifique que la conexión se establezca correctamente y que el audio se esté traduciendo.

¿Qué es la API compatible con OpenAI?

La API compatible con OpenAI es una opción de proveedor genérica que permite a Sokuji conectarse a cualquier servicio que implemente el protocolo Realtime API de OpenAI:

• Use cualquier endpoint compatible con OpenAI con una URL base personalizada
• Admite servicios tanto en la nube como autohospedados
• Flexibilidad para cambiar entre diferentes proveedores backend
• Útil para implementaciones privadas, optimización de costos o cumplimiento regional

Sobre la compatibilidad del proveedor

La mayoría de los servicios compatibles con OpenAI solo admiten la API de Chat Completions. La Realtime API (basada en WebSocket, con transmisión de audio) es un protocolo diferente y muy pocos proveedores la admiten:

• Azure OpenAI Service: Admite la Realtime API con modelos de OpenAI alojados en Microsoft Azure
• Verifique siempre la documentación de su proveedor para soporte explícito de Realtime API
• Servicios como OpenRouter, Together AI, etc. típicamente NO admiten la Realtime API
• Algunos servicios proxy (por ejemplo, CometAPI) pueden ofrecer compatibilidad con Realtime API — verifique antes de usar
• Las soluciones autohospedadas deben implementar el protocolo WebSocket completo de la Realtime API

Consejos de configuración

• La URL del endpoint no debe incluir una barra final (por ejemplo, use https://api.example.com no https://api.example.com/)
• Para servicios locales, use http://localhost:<port> como endpoint
• Algunos proveedores pueden requerir encabezados específicos o métodos de autenticación
• Si usa un servicio proxy, asegúrese de que reenvíe las conexiones WebSocket correctamente

Problemas comunes

Conexión rechazada: Verifique que la URL del endpoint sea correcta y que el servicio esté en ejecución. Para servicios locales, compruebe que el servidor esté iniciado y escuchando en el puerto esperado.

Error de autenticación: Verifique su clave API. Algunos proveedores requieren formatos de clave específicos. Asegúrese de que su cuenta tenga acceso a la Realtime API.

Modelo no encontrado: El nombre del modelo puede diferir de los modelos predeterminados de OpenAI. Consulte la documentación de su proveedor para los nombres de modelos disponibles.

Conexión WebSocket fallida: Asegúrese de que su proveedor admita conexiones WebSocket para la Realtime API. Los endpoints estándar solo HTTP (Chat Completions) no funcionarán.

Verificación de compatibilidad del proveedor

1. Verifique que su proveedor admita explícitamente el protocolo Realtime API de OpenAI
2. Compruebe que se admitan conexiones WebSocket (no solo REST API)
3. Confirme que el proveedor admita transmisión de audio de entrada/salida
4. Pruebe la URL del endpoint directamente con un cliente WebSocket si es posible
5. Revise la documentación del proveedor para cualquier requisito de configuración específico