Überblick
Dieser Endpunkt ist für Echtzeit-Sitzungen wie Spracherkennung, Sprachsynthese, Sprachübersetzung oder multimodale Realtime-Modelle gedacht. NormaleGET-Anfragen liefern Metadaten; WebSocket-Upgrades werden an die geroutete Realtime-Upstream-Sitzung weitergeleitet.
Unterstützte Oberfläche
Dieser Endpunkt ist TokenLabs Realtime-WebSocket-Proxy. Er unterstützt einen normalenGET /v1/realtime-Metadatencheck und WebSocket-Upgrades auf demselben Pfad. Er stellt keine OpenAI-Realtime-REST-Hilfsendpunkte bereit, etwa POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) oder die Erstellung von legacy beta REST session / transcription-session.
Für Browser- oder Mobile-Apps sollten langfristige API-Keys auf Ihrem Server bleiben. Dieser Endpunkt stellt keine kurzlebigen Realtime client secrets aus.
Agents sollten zuerst über
/v1/models ein realtime-fähiges Modell finden und erst danach den Socket öffnen.Verbindung
string
erforderlich
Realtime-Modell-ID. Wählen Sie ein Modell, dessen unterstützte Operationen realtime unterstützt.
string
erforderlich
Bearer-API-Key. WebSocket-Clients senden beim Upgrade
Authorization: Bearer sk-your-api-key.Nachrichten
TokenLab leitet WebSocket-Nachrichten zwischen Client und geroutetem Realtime-Anbieter weiter. Verwenden Sie die offiziellen Event-Formate des gewählten Modells und geben Siemodel in der Query an.
Abrechnung und Schließen
Realtime-Sitzungen nutzen dasselbe API-Key-Guthaben. TokenLab zieht beim Öffnen eine kleine Schätzung vorab ab und rechnet beim Schließen ab oder erstattet. Schließen Sie den Client-Socket, wenn die Sitzung beendet ist. Schließt der Upstream zuerst, leitet TokenLab den Close-Code nach Möglichkeit weiter.Antwortbeispiel
Wichtige Felder
string
Von der API zurückgegebener Event- oder Nachrichtentyp.
string
Kennung des Realtime-Anbieters; verwenden Sie sie in Support-Logs, nicht als REST session URL.