c.AI.Chat(ctx, request) は、OpenAI 互換のチャット補完 endpoint である AI Gateway を呼び出します。ai:chat スコープと Standard 以上のプランが必要です。
リクエスト
squarecloud.ChatRequest のフィールドと、その JSON 名:
レスポンスは OpenAI の形式の
ChatCompletion です: ID、Object、Created、Model、Choices (Index、Message、FinishReason)、Usage (PromptTokens、CompletionTokens、TotalTokens)。
ストリーミングなし
AI.Chat はストリーミングしません。補完全体を返します。ChatRequest には stream フィールドがなく、API は stream: true に対して 400 stream_not_supported を返します。
タイムアウト
ゲートウェイは各リクエストに合計 90 秒を与え、それを過ぎると 503server_overloaded を返します。ctx に期限がない場合、SDK はタイムアウトまで最低 2 分待機するため、ゲートウェイからの応答を受け取れます。
エラー
AI のエラーは OpenAI の形式を使うため、コードは小文字です。それでも*APIError として返され、Code には OpenAI のコード (コードがない場合はその type) が設定されます:
AI のエラーは、非冪等な
POST リクエストであるため、SDK がリトライすることはありません。プランの上限については AI Gateway リファレンスを参照してください。
