Skip to main content
client.ai.chat(request) は、OpenAI 互換のチャット補完 endpoint である AI Gateway を呼び出します。ai:chat スコープと Standard 以上のプランが必要です。

リクエスト

request はボディとしてそのまま送信される dict なので、その他の OpenAI パラメーターもそのまま渡せます。型は squarecloud.types.ChatRequest です。 レスポンスは OpenAI の形式です: id、object、created、model、choices (index、message、finish_reason)、usage。

ストリーミングなし

ai.chat() はストリーミングを行わず、補完全体を返します。"stream": True は 400 stream_not_supported になります。

タイムアウト

ゲートウェイは各リクエストに合計 90 秒を割り当て、それを過ぎると 503 server_overloaded を返します。SDK はタイムアウトまで最低 120 秒待機するため、ゲートウェイからの応答を受け取れます。

エラー

AI のエラーは OpenAI の形式を使うため、コードは小文字です。それでも SquareCloudAPIError として送出され、code には OpenAI のコード (コードがない場合はその type) が設定されます:
AI のエラーは SDK によってリトライされることはありません。リクエストが冪等でない POST であるためです。プランの制限については AI Gateway リファレンスを参照してください。