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.
Les extraits plus courts ci-dessous s’exécutent dans le programme présenté dans Exécuter les exemples : collez-en un à la fois dans main et lancez goimports.
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.
Prochaines étapes
Erreurs
Classe d’erreur, nouvelles tentatives et limites de débit.
Référence de l'AI Gateway
Modèles, limites par plan et endpoint compatible OpenAI.

