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 disquarecloud.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 503server_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.
