api.ai.chat(request) llama al AI Gateway, un endpoint de chat completions compatible con OpenAI. Necesita el scope ai:chat y un plan Standard o superior.
Petición
La respuesta tiene la forma de OpenAI:
id, object, created, model, choices (index, message, finish_reason) y usage.
Sin streaming
ai.chat() no hace streaming: devuelve la respuesta completa. stream: true da 400 stream_not_supported.
Timeout
El gateway concede a cada petición 90 segundos en total y después responde 503server_overloaded. El SDK espera al menos 120 s antes de agotar el tiempo, así que recibes la respuesta del gateway.
Errores
Los errores de IA usan el formato de OpenAI, así que sus códigos están en minúsculas. Aun así lanzan unSquareCloudAPIError, con code igual al código de OpenAI (o a su type cuando no hay código):
El SDK nunca reintenta los errores de IA: la petición es un
POST no idempotente. Consulta la referencia del AI Gateway para ver los límites de cada plan.
