Tutoriel de configuration de l'API compatible OpenAI

1Choisissez un fournisseur compatible

Sélectionnez un service prenant en charge le protocole WebSocket de la Realtime API d'OpenAI. Important : Très peu de fournisseurs prennent actuellement en charge la Realtime API — la plupart des services compatibles OpenAI ne prennent en charge que l'API Chat Completions, ce qui est insuffisant. Vérifiez toujours que votre fournisseur prend explicitement en charge la Realtime API avant de continuer.

2Obtenez votre endpoint API et votre clé

Obtenez l'URL de l'endpoint API et la clé API de votre fournisseur choisi. L'URL de l'endpoint est généralement au format https://your-provider.com ou http://localhost:8080 pour les services auto-hébergés.

3Sélectionnez API compatible OpenAI dans Sokuji

Ouvrez Sokuji et accédez au panneau Paramètres. Sélectionnez "OpenAI Compatible API" comme fournisseur IA dans le menu déroulant des fournisseurs.

4Entrez votre configuration

Collez votre URL d'endpoint API personnalisée dans le champ "API Endpoint". Entrez votre clé API dans le champ "API Key". Si votre fournisseur ne nécessite pas de clé API (par exemple, services locaux), vous pouvez laisser vide ou entrer une valeur de substitution.

5Sélectionnez le modèle et la voix

Choisissez les paramètres de modèle et de voix pris en charge par votre fournisseur. Les options disponibles dépendent de votre fournisseur spécifique. Les modèles courants incluent gpt-4o-realtime-preview ou des noms de modèles spécifiques au fournisseur.

6Testez la connexion

Démarrez une session de traduction pour vérifier que tout fonctionne. Cliquez sur le bouton Démarrer la session, parlez dans votre microphone et vérifiez que la connexion s'établit correctement et que l'audio est traduit.

Qu'est-ce que l'API compatible OpenAI ?

L'API compatible OpenAI est une option de fournisseur générique permettant à Sokuji de se connecter à tout service implémentant le protocole Realtime API d'OpenAI :

• Utilisez n'importe quel endpoint compatible OpenAI avec une URL de base personnalisée
• Prend en charge les services hébergés dans le cloud et auto-hébergés
• Flexibilité pour basculer entre différents fournisseurs backend
• Utile pour les déploiements privés, l'optimisation des coûts ou la conformité régionale

À propos de la compatibilité des fournisseurs

La plupart des services compatibles OpenAI ne prennent en charge que l'API Chat Completions. La Realtime API (basée sur WebSocket, avec streaming audio) est un protocole différent et très peu de fournisseurs la prennent en charge :

• Azure OpenAI Service : Prend en charge la Realtime API avec les modèles OpenAI hébergés sur Microsoft Azure
• Vérifiez toujours la documentation de votre fournisseur pour la prise en charge explicite de la Realtime API
• Les services comme OpenRouter, Together AI, etc. ne prennent généralement PAS en charge la Realtime API
• Certains services proxy (par ex. CometAPI) peuvent offrir la compatibilité Realtime API — vérifiez avant utilisation
• Les solutions auto-hébergées doivent implémenter le protocole WebSocket complet de la Realtime API

Conseils de configuration

• L'URL de l'endpoint ne doit pas inclure de barre oblique finale (par ex. utilisez https://api.example.com et non https://api.example.com/)
• Pour les services locaux, utilisez http://localhost:<port> comme endpoint
• Certains fournisseurs peuvent nécessiter des en-têtes spécifiques ou des méthodes d'authentification
• Si vous utilisez un service proxy, assurez-vous qu'il transmet correctement les connexions WebSocket

Problèmes courants

Connexion refusée: Vérifiez que l'URL de l'endpoint est correcte et que le service est en cours d'exécution. Pour les services locaux, vérifiez que le serveur est démarré et écoute sur le port attendu.

Erreur d'authentification: Vérifiez votre clé API. Certains fournisseurs nécessitent des formats de clé spécifiques. Assurez-vous que votre compte a accès à la Realtime API.

Modèle non trouvé: Le nom du modèle peut différer des modèles par défaut d'OpenAI. Consultez la documentation de votre fournisseur pour les noms de modèles disponibles.

Échec de connexion WebSocket: Assurez-vous que votre fournisseur prend en charge les connexions WebSocket pour la Realtime API. Les endpoints HTTP standard uniquement (Chat Completions) ne fonctionneront pas.

Vérification de la compatibilité du fournisseur

1. Vérifiez que votre fournisseur prend explicitement en charge le protocole Realtime API d'OpenAI
2. Vérifiez que les connexions WebSocket sont prises en charge (pas seulement l'API REST)
3. Confirmez que le fournisseur prend en charge le streaming audio entrée/sortie
4. Testez l'URL de l'endpoint directement avec un client WebSocket si possible
5. Consultez la documentation du fournisseur pour d'éventuelles exigences de configuration spécifiques