api.ai.chat(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
La réponse a la forme OpenAI :
id, object, created, model, choices (index, message, finish_reason) et usage.
Pas de streaming
ai.chat() ne diffuse pas en flux : elle renvoie la completion entière. stream: true donne 400 stream_not_supported.
Timeout
La gateway accorde à chaque requête 90 secondes au total, puis répond 503server_overloaded. Le SDK attend au moins 120 s 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 lèvent tout de même uneSquareCloudAPIError, 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.
