api.ai.chat(request) は、OpenAI 互換のチャット補完 endpoint である AI Gateway を呼び出します。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) が設定されます:
AI のエラーは SDK によってリトライされることはありません。リクエストが冪等でない
POST であるためです。プランの制限については AI Gateway リファレンスを参照してください。
