aisplice

API-Referenz

Echtzeit

Noch kein Modell verfügbar

Derzeit unterstützt kein Modell im Modellkatalog diese Route. Die Seite bleibt als Referenz erhalten.
WS/v1/realtime

Nutzen Sie den Realtime-Endpunkt, wenn Text und Audio über eine dauerhafte Verbindung laufen sollen. Er ist durch denselben API-Schlüssel, denselben Schlüsselbereich, dieselben Modellberechtigungen und Ratenlimits geschützt wie die HTTP-API.

#Vom Server aus verbinden

Öffnen Sie den WebSocket aus einem vertrauenswürdigen Serverprozess und senden Sie beim Handshake Authorization: Bearer mit dem API-Schlüssel. Legen Sie keinen langlebigen API-Schlüssel in Browser-JavaScript offen: Browser können diesen Header nicht sicher anhängen, und jeder kann einen ausgelieferten Schlüssel auslesen.

server.ts
import WebSocket from "ws";

const socket = new WebSocket("wss://YOUR_DOMAIN/v1/realtime", {
  headers: { Authorization: "Bearer sk-YOUR_KEY" },
});

socket.on("open", () => {
  // Send standard Realtime session and conversation events here.
});

socket.on("message", (event) => {
  // Forward text / audio deltas to your client.
});

#Sitzungs- und Event-Ablauf

Senden Sie nach dem Verbinden die standardmäßigen Realtime-Session- und Conversation-Events für das gewählte Modell. Leiten Sie Server-Events über Ihren eigenen kurzlebigen Kanal an den Browser weiter; so bleiben Plattformschlüssel und Upstream-WebSocket unter Ihrer Kontrolle.

1

Verbinden

Einen authentifizierten serverseitigen Socket öffnen.

2

Konfigurieren

Sitzungskonfiguration und Gesprächseingaben senden.

3

Weiterleiten

Deltas an Ihren Client weiterleiten und die Sitzung schließen, wenn sie beendet ist.

#Bewusst neu verbinden

Ein WebSocket ist zustandsbehaftet. Wird die Verbindung geschlossen, erstellen Sie eine neue Sitzung und spielen Sie nur den Anwendungszustand erneut ein, den Sie bewusst behalten haben. Behandeln Sie 401, 403, 402 und 429 als konkrete Signale zu Konto oder Schlüssel; wiederholen Sie vorübergehende Netzwerk- und 5xx-Fehler mit begrenztem Backoff.

Beginnen Sie mit HTTP, wenn Sie kein Live-Audio brauchen

Für normales Text-Streaming ist /v1/chat/completions einfacher zu deployen und nutzt Server-Sent Events. Wechseln Sie zu Realtime, wenn eine dauerhafte Sitzung mit geringer Latenz Teil des Produkterlebnisses ist.

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückXsolla-PrüfungWeiterGoogle-Play-Abos