Skip to main content
c.AI.Chat(ctx, request) 调用 AI Gateway,这是一个兼容 OpenAI 的聊天补全 endpoint。它需要 ai:chat 作用域以及 Standard 或更高级别的套餐。

请求

squarecloud.ChatRequest 的字段及其 JSON 名称: 响应是一个采用 OpenAI 结构的 ChatCompletion:ID、Object、Created、Model、Choices(Index、Message、FinishReason)和 Usage(PromptTokens、CompletionTokens、TotalTokens)。

不支持流式传输

AI.Chat 不进行流式传输:它返回完整的补全结果。ChatRequest 没有 stream 字段;对于 stream: true,API 会返回 400 stream_not_supported。

超时

网关为每个请求总共提供 90 秒,之后返回 503 server_overloaded。在 ctx 没有截止时间的情况下,SDK 至少等待 2 分钟才会超时,因此你会收到网关的响应。

错误

AI 错误使用 OpenAI 格式,因此其代码为小写。它们仍然以 *APIError 的形式返回,Code 被设为 OpenAI 代码(没有代码时则为其 type):
SDK 从不重试 AI 错误:该请求是非幂等的 POST。套餐限制请参见 AI Gateway 参考。