Skip to main content
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 503 server_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 un SquareCloudAPIError, 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.