c.AI.Chat(ctx, request) appelle l’AI Gateway, un endpoint de chat completions compatible OpenAI. Il nécessite le scope ai:chat et un plan Standard ou supérieur.
Requête
Champs desquarecloud.ChatRequest, avec leurs noms JSON :
La réponse est un
ChatCompletion de forme OpenAI : ID, Object, Created, Model, Choices (Index, Message, FinishReason) et Usage (PromptTokens, CompletionTokens, TotalTokens).
Pas de streaming
AI.Chat ne diffuse pas en flux : elle renvoie la completion entière. ChatRequest n’a pas de champ stream ; l’API répond 400 stream_not_supported à stream: true.
Timeout
La gateway accorde à chaque requête 90 secondes au total, puis répond 503server_overloaded. Sans échéance sur ctx, le SDK attend au moins 2 minutes avant d’expirer, vous recevez donc la réponse de la gateway.
Erreurs
Les erreurs d’IA utilisent le format OpenAI, leurs codes sont donc en minuscules. Elles sont tout de même renvoyées sous forme d’une*APIError, avec Code défini sur le code OpenAI (ou sur son type en l’absence de code) :
Le SDK ne réessaie jamais les erreurs d’IA : la requête est un
POST non idempotent. Consultez la référence de l’AI Gateway pour les limites des plans.
