Gemini APIで503エラーが多発するトラブルが起きる

Gemini APIで50x系エラーが多発するトラブルが起きる

解決メモ

Gemini Interactions APIのストリーミングでは、REST直叩き時にURLへ ?alt=sse を付ける必要がある。

これが欠落すると、stream: true を指定していてもSSEとして正しく逐次処理されず、レスポンス全体のバッファリング、first_textの大幅遅延、503/タイムアウト的挙動につながる可能性がある。

今回の自作テキスト処理アプリでは、/v1beta/interactions に対する streaming request で ?alt=sse が欠落していた。

追加後、Gemini 3.5 Flashの応答速度が改善した。

教訓:

stream: true だけでは不十分な場合がある

RESTでSSEを受けるなら ?alt=sse を確認する

SDK利用時は内部で処理される可能性があるが、REST実装では明示する

first_text_secが異様に遅い場合はSSE設定を疑う