Tutorial di configurazione API compatibile con OpenAI

1Scegli un fornitore compatibile

Seleziona un servizio che supporti il protocollo WebSocket della Realtime API di OpenAI. Importante: Pochissimi fornitori attualmente supportano la Realtime API — la maggior parte dei servizi compatibili con OpenAI supporta solo l'API Chat Completions, che non è sufficiente. Verifica sempre che il tuo fornitore supporti esplicitamente la Realtime API prima di procedere.

2Ottieni il tuo endpoint API e la chiave

Ottieni l'URL dell'endpoint API e la chiave API dal fornitore scelto. L'URL dell'endpoint è tipicamente nel formato https://your-provider.com o http://localhost:8080 per servizi auto-ospitati.

3Seleziona API compatibile con OpenAI in Sokuji

Apri Sokuji e naviga al pannello Impostazioni. Seleziona "OpenAI Compatible API" come fornitore di IA dal menu a discesa dei fornitori.

4Inserisci la tua configurazione

Incolla l'URL del tuo endpoint API personalizzato nel campo "API Endpoint". Inserisci la tua chiave API nel campo "API Key". Se il tuo fornitore non richiede una chiave API (ad es. servizi locali), puoi lasciarlo vuoto o inserire un valore segnaposto.

5Seleziona modello e voce

Scegli le impostazioni del modello e della voce supportate dal tuo fornitore. Le opzioni disponibili dipendono dal tuo fornitore specifico. I modelli comuni includono gpt-4o-realtime-preview o nomi di modelli specifici del fornitore.

6Testa la connessione

Avvia una sessione di traduzione per verificare che tutto funzioni. Clicca il pulsante Avvia sessione, parla nel microfono e verifica che la connessione venga stabilita con successo e che l'audio venga tradotto.

Cos'è l'API compatibile con OpenAI?

L'API compatibile con OpenAI è un'opzione di fornitore generica che consente a Sokuji di connettersi a qualsiasi servizio che implementa il protocollo Realtime API di OpenAI:

• Usa qualsiasi endpoint compatibile con OpenAI con un URL base personalizzato
• Supporta sia servizi cloud che auto-ospitati
• Flessibilità nel passare tra diversi fornitori backend
• Utile per distribuzioni private, ottimizzazione dei costi o conformità regionale

Sulla compatibilità dei fornitori

La maggior parte dei servizi compatibili con OpenAI supporta solo l'API Chat Completions. La Realtime API (basata su WebSocket, con streaming audio) è un protocollo diverso e pochissimi fornitori la supportano:

• Azure OpenAI Service: Supporta la Realtime API con modelli OpenAI ospitati su Microsoft Azure
• Verifica sempre la documentazione del tuo fornitore per il supporto esplicito alla Realtime API
• Servizi come OpenRouter, Together AI, ecc. tipicamente NON supportano la Realtime API
• Alcuni servizi proxy (ad es. CometAPI) potrebbero offrire compatibilità con la Realtime API — verifica prima dell'uso
• Le soluzioni auto-ospitate devono implementare il protocollo WebSocket completo della Realtime API

Suggerimenti di configurazione

• L'URL dell'endpoint non deve includere una barra finale (ad es. usa https://api.example.com non https://api.example.com/)
• Per servizi locali, usa http://localhost:<port> come endpoint
• Alcuni fornitori potrebbero richiedere header specifici o metodi di autenticazione
• Se usi un servizio proxy, assicurati che inoltri correttamente le connessioni WebSocket

Problemi comuni

Connessione rifiutata: Verifica che l'URL dell'endpoint sia corretto e che il servizio sia in esecuzione. Per servizi locali, controlla che il server sia avviato e in ascolto sulla porta prevista.

Errore di autenticazione: Ricontrolla la tua chiave API. Alcuni fornitori richiedono formati di chiave specifici. Assicurati che il tuo account abbia accesso alla Realtime API.

Modello non trovato: Il nome del modello potrebbe differire dai modelli predefiniti di OpenAI. Consulta la documentazione del tuo fornitore per i nomi dei modelli disponibili.

Connessione WebSocket fallita: Assicurati che il tuo fornitore supporti connessioni WebSocket per la Realtime API. Gli endpoint standard solo HTTP (Chat Completions) non funzioneranno.

Verifica della compatibilità del fornitore

1. Verifica che il tuo fornitore supporti esplicitamente il protocollo Realtime API di OpenAI
2. Controlla che le connessioni WebSocket siano supportate (non solo REST API)
3. Conferma che il fornitore supporti lo streaming audio in ingresso/uscita
4. Testa l'URL dell'endpoint direttamente con un client WebSocket se possibile
5. Consulta la documentazione del fornitore per eventuali requisiti di configurazione specifici