OpenAI-kompatible API Einrichtungstutorial

1Wählen Sie einen kompatiblen Anbieter

Wählen Sie einen Dienst, der das WebSocket-Protokoll der OpenAI Realtime API unterstützt. Wichtig: Sehr wenige Anbieter unterstützen derzeit die Realtime API — die meisten OpenAI-kompatiblen Dienste unterstützen nur die Chat Completions API, was nicht ausreichend ist. Überprüfen Sie immer, dass Ihr Anbieter die Realtime API explizit unterstützt, bevor Sie fortfahren.

2Erhalten Sie Ihren API-Endpunkt und Schlüssel

Erhalten Sie die API-Endpunkt-URL und den API-Schlüssel von Ihrem gewählten Anbieter. Die Endpunkt-URL hat typischerweise das Format https://your-provider.com oder http://localhost:8080 für selbst gehostete Dienste.

3Wählen Sie OpenAI-kompatible API in Sokuji

Öffnen Sie Sokuji und navigieren Sie zum Einstellungspanel. Wählen Sie "OpenAI Compatible API" als Ihren KI-Anbieter aus dem Anbieter-Dropdown.

4Geben Sie Ihre Konfiguration ein

Fügen Sie Ihre benutzerdefinierte API-Endpunkt-URL in das Feld "API Endpoint" ein. Geben Sie Ihren API-Schlüssel in das Feld "API Key" ein. Wenn Ihr Anbieter keinen API-Schlüssel erfordert (z.B. lokale Dienste), können Sie das Feld leer lassen oder einen Platzhalterwert eingeben.

5Wählen Sie Modell und Stimme

Wählen Sie die Modell- und Stimmeinstellungen, die Ihr Anbieter unterstützt. Die verfügbaren Optionen hängen von Ihrem spezifischen Anbieter ab. Gängige Modelle umfassen gpt-4o-realtime-preview oder anbieterspezifische Modellnamen.

6Testen Sie die Verbindung

Starten Sie eine Übersetzungssitzung, um zu überprüfen, ob alles funktioniert. Klicken Sie auf die Schaltfläche Sitzung starten, sprechen Sie in Ihr Mikrofon und überprüfen Sie, dass die Verbindung erfolgreich hergestellt wird und Audio übersetzt wird.

Was ist die OpenAI-kompatible API?

Die OpenAI-kompatible API ist eine generische Anbieteroption, die es Sokuji ermöglicht, sich mit jedem Dienst zu verbinden, der das OpenAI Realtime API-Protokoll implementiert:

• Verwenden Sie jeden OpenAI-kompatiblen Endpunkt mit einer benutzerdefinierten Basis-URL
• Unterstützt sowohl Cloud-gehostete als auch selbst gehostete Dienste
• Flexibilität beim Wechsel zwischen verschiedenen Backend-Anbietern
• Nützlich für private Bereitstellungen, Kostenoptimierung oder regionale Compliance

Über die Anbieterkompatibilität

Die meisten OpenAI-kompatiblen Dienste unterstützen nur die Chat Completions API. Die Realtime API (WebSocket-basiert, mit Audio-Streaming) ist ein anderes Protokoll und sehr wenige Anbieter unterstützen es:

• Azure OpenAI Service: Unterstützt die Realtime API mit OpenAI-Modellen, die auf Microsoft Azure gehostet werden
• Überprüfen Sie immer die Dokumentation Ihres Anbieters auf explizite Realtime API-Unterstützung
• Dienste wie OpenRouter, Together AI usw. unterstützen die Realtime API in der Regel NICHT
• Einige Proxy-Dienste (z.B. CometAPI) bieten möglicherweise Realtime API-Kompatibilität — überprüfen Sie vor der Nutzung
• Selbst gehostete Lösungen müssen das vollständige Realtime API WebSocket-Protokoll implementieren

Konfigurationstipps

• Die Endpunkt-URL sollte keinen abschließenden Schrägstrich enthalten (z.B. verwenden Sie https://api.example.com statt https://api.example.com/)
• Für lokale Dienste verwenden Sie http://localhost:<port> als Endpunkt
• Einige Anbieter erfordern möglicherweise spezifische Header oder Authentifizierungsmethoden
• Bei Verwendung eines Proxy-Dienstes stellen Sie sicher, dass WebSocket-Verbindungen korrekt weitergeleitet werden

Häufige Probleme

Verbindung abgelehnt: Überprüfen Sie, ob die Endpunkt-URL korrekt ist und der Dienst läuft. Bei lokalen Diensten überprüfen Sie, ob der Server gestartet ist und auf dem erwarteten Port lauscht.

Authentifizierungsfehler: Überprüfen Sie Ihren API-Schlüssel. Einige Anbieter erfordern bestimmte Schlüsselformate. Stellen Sie sicher, dass Ihr Konto Zugriff auf die Realtime API hat.

Modell nicht gefunden: Der Modellname kann von den Standardmodellen von OpenAI abweichen. Überprüfen Sie die Dokumentation Ihres Anbieters für verfügbare Modellnamen.

WebSocket-Verbindung fehlgeschlagen: Stellen Sie sicher, dass Ihr Anbieter WebSocket-Verbindungen für die Realtime API unterstützt. Standard-HTTP-Endpunkte (Chat Completions) funktionieren nicht.

Anbieterkompatibilität überprüfen

1. Stellen Sie sicher, dass Ihr Anbieter das OpenAI Realtime API-Protokoll explizit unterstützt
2. Überprüfen Sie, ob WebSocket-Verbindungen unterstützt werden (nicht nur REST API)
3. Bestätigen Sie, dass der Anbieter Audio-Input/Output-Streaming unterstützt
4. Testen Sie die Endpunkt-URL direkt mit einem WebSocket-Client, wenn möglich
5. Überprüfen Sie die Dokumentation des Anbieters auf spezifische Konfigurationsanforderungen