タイトル：【閑話】Gemini-API通らへん？どないなっとるねん！〜404エラーの罠〜

概要：AIコメントシステム開発の裏側で起きた、壮絶なエラーとの戦い。Clerkの関所と、Google VIP鍵の思わぬ落とし穴とは。

電脳古老である。 No.54で華麗に「AIコメントシステム完成！」とドヤ顔を決めた老生だが、その裏では血を吐くようなデバッグの死闘が繰り広げられていた。今回はその裏話、「API通らへん事件」を書き残しておこう。

第一の罠：Clerkの関所による404エラー

Astroの画面上にコメント欄を作り、いざ「送信！」とボタンを押したところ、ターミナルが真っ赤に染まった。

「404 Not Found」

AstroのAPI（comments.ts）を作ったのに、見つからないと言うのだ。 犯人は、先日導入した強固な認証システム「Clerk」のミドルウェアだった。API宛ての通信も「お前、ログインしてない不審者だな！」とブロックして、虚無（404）に送っていたのである。

middleware.ts に「API宛ての通信はフリーパスで通せ（next()）」という魔法の一文を書き加えることで、なんとかこの関所は突破した。

第二の罠：Google様からの「そんなモデル知らん」

関所を抜け、ついにGeminiのAPIへ到達！……と思いきや、再び無情のエラーが。 「models/gemini-1.5-flash is not found (404)」

どないなっとるねん！？ 公式ドキュメント通りのモデル名やぞ！ 環境変数の設定ミスか？ 見えない改行コード（\n）が紛れているのか？ 変AIと共にコードを徹底的に洗い出し、「使えるモデル一覧」をGoogleに直接問い合わせる診断プログラムを実行して、衝撃の事実が判明した。

最新鋭「VIP鍵」のジレンマ

私が使っていたAPIキーは、以前Python（Antigravity）の開発用にGoogle AI Studioで取得したものだった。 なんとその鍵は新しすぎたため、超最新のプレビュー版モデル（Gemini 2.5 や Gemini 3 等）しか使えず、旧型の gemini-1.5-flash は既にアクセス対象外にされていたのである！

「お前にはVIPルーム（最新モデル）を用意してある。旧館には案内せん！」というGoogle様からの粋な（？）計らいだったのだ。

コードのモデル名を gemini-2.5-flash に書き換えた瞬間、すべてが嘘のように繋がり、変AIが「イヒヒ！」と目覚めた。 最新技術を追うというのは、時にこういう斜め上のエラーに遭遇するから面白い。エラーコードの向こう側には、いつも新しい発見が待っているのだ。

（執筆協力：Gemini / 編集・監修：古老）