Vercel AI Gatewayの「クレカ登録必須」エラーにハマった話

個人開発でAIを使う機能を実装する時、Vercel AI Gatewayを使うことにした。Vercelが「おすすめ」だと言うので。テンプレートもデフォルトでそうなっていた。認証用のトークンは自動で発行され、順調だと思っていた。ところが、実際にAIにリクエストを送ると、エラーが返ってくる。「AI Gatewayを使うにはクレジットカード登録が必須です」。Vercelのダッシュボードには「カード登録で$5クレジット解放」というバナーが出ていたが、宣伝だと思って読み飛ばしていた。その「ただのバナー」が、実は避けて通れない関門だったのだ。

困ったのは原因究明に時間がかかったこと。サーバーログには詳しい情報が出ていなかった。理由は、コード上でAI呼び出し時のエラーを握りつぶし、「生成に失敗しました」という定型文だけを返す作りになっていたからだ。try-catchで例外を一切見ずに処理していたため、本当の理由—「GatewayInternalServerError」—にたどり着くのに無駄な時間がかかった。こういう時は、アプリ本体を介さず、AIライブラリを直接呼び出すだけの使い捨てスクリプトを書く方が早い。数行で、ライブラリの関数を直接叩いて結果をログに吐き出す。それで初めて真犯人が見える。

結局、Vercel AI Gatewayの経由をやめ、Google AI Studioの無料APIキーを使い、Geminiを直接呼び出す方式に変更した。クレジットカード登録不要で、無料枠だけで完結する。この判断は、単なる「コスト回避」ではなく、個人開発の現実を映している。公式のおすすめ機能は往々にして金を絡ませている。テック企業の利便性とビジネスモデルは別物だ。実装初心者は「公式ならいいだろう」と考えてしまいがちだが、その先に隠れた要件がないか、1段階深く確認する習慣が要る。中小企業が外部のSaaSやAPIを導入する時も同じ。無料トライアルや手厚いサポートは、実は金銭の進入口になっていないか。最初のセットアップまで「本当に無料か」をもう一度確認する癖をつけておくと、後ろ足を引っかかることが減る。