api.ai.chat(request) 调用 AI Gateway,这是一个兼容 OpenAI 的聊天补全 endpoint。它需要 ai:chat 作用域以及 Standard 或更高级别的套餐。
请求
响应采用 OpenAI 的格式:
id、object、created、model、choices(index、message、finish_reason)和 usage。
不支持流式传输
ai.chat() 不进行流式传输:它返回完整的补全结果。stream: true 会返回 400 stream_not_supported。
超时
网关为每个请求总共提供 90 秒,之后返回 503server_overloaded。SDK 至少等待 120 秒才会超时,因此你会收到网关的响应。
错误
AI 错误使用 OpenAI 格式,因此其代码为小写。它们仍然会抛出SquareCloudAPIError,code 被设为 OpenAI 代码(没有代码时则为其 type):
SDK 从不重试 AI 错误:该请求是非幂等的
POST。套餐限制请参见 AI Gateway 参考。
