Skip to main content
client.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

request est un dict envoyé tel quel comme corps, de sorte que tout autre paramètre OpenAI est transmis. Il est typé squarecloud.types.ChatRequest. 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 503 server_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 une SquareCloudAPIError, 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.