Skip to main content
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 de squarecloud.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 503 server_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.