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.
Los ejemplos usan el cliente api de Crear el cliente.
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.
Próximos pasos
Errores
Clase de error, reintentos y límites de tasa.
Referencia del AI Gateway
Modelos, límites por plan y el endpoint compatible con OpenAI.

