aisplice

Riferimento API

Tempo reale

Nessun modello lo supporta ancora

Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
WS/v1/realtime

Usa l'endpoint Realtime quando testo e audio devono viaggiare su un'unica connessione persistente. È protetto dalla stessa chiave API, dallo stesso ambito della chiave, dagli stessi permessi sui modelli e dagli stessi limiti di frequenza dell'API HTTP.

#Connettiti dal tuo server

Apri il WebSocket da un processo server attendibile e invia Authorization: Bearer con la chiave API durante l'handshake. Non esporre una chiave API di lunga durata nel JavaScript del browser: i browser non possono allegare questo header in modo sicuro e chiunque può estrarre una chiave distribuita con l'app.

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.
});

#Flusso di sessione ed eventi

Dopo la connessione, invia gli eventi standard di sessione e conversazione Realtime per il modello selezionato. Inoltra gli eventi del server al browser tramite un tuo canale di breve durata; così la chiave della piattaforma e il WebSocket upstream restano sotto il tuo controllo.

1

Connetti

Apri un socket autenticato lato server.

2

Configura

Invia la configurazione della sessione e l'input della conversazione.

3

Inoltra

Inoltra i delta al tuo client e chiudi la sessione al termine.

#Riconnettiti in modo consapevole

Un WebSocket ha uno stato. Se la connessione si chiude, crea una nuova sessione e riproduci solo lo stato dell'applicazione che hai scelto di conservare. Considera 401, 403, 402 e 429 come segnali su account o chiave su cui intervenire; riprova i problemi di rete transitori e i 5xx con un backoff limitato.

Parti da HTTP se non ti serve l'audio dal vivo

Per il normale testo in streaming, /v1/chat/completions è più semplice da distribuire e usa i server-sent events. Passa a Realtime quando una sessione persistente a bassa latenza fa parte dell'esperienza del prodotto.

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteVerifica XsollaSuccessivoAbbonamenti Google Play