Skip to main content
c.AI.Chat(ctx, request) chiama l’AI Gateway, un endpoint di chat completion compatibile con OpenAI. Richiede lo scope ai:chat e un piano Standard o superiore.

Richiesta

Campi di squarecloud.ChatRequest, con i relativi nomi JSON: La risposta è un ChatCompletion con la forma di OpenAI: ID, Object, Created, Model, Choices (Index, Message, FinishReason) e Usage (PromptTokens, CompletionTokens, TotalTokens).

Niente streaming

AI.Chat non usa lo streaming: restituisce l’intera completion. ChatRequest non ha un campo stream; l’API risponde 400 stream_not_supported a stream: true.

Timeout

Il gateway concede a ogni richiesta 90 secondi in totale, poi risponde 503 server_overloaded. Senza una scadenza su ctx, l’SDK attende almeno 2 minuti prima di andare in timeout, così ricevi la risposta del gateway.

Errori

Gli errori dell’AI usano il formato di OpenAI, quindi i loro codici sono in minuscolo. Vengono comunque restituiti come *APIError, con Code impostato sul codice di OpenAI (o sul suo type quando non c’è un codice):
L’SDK non ripete mai gli errori dell’AI: la richiesta è un POST non idempotente. Vedi il riferimento dell’AI Gateway per i limiti dei piani.