AI の API を使い続ける技術メモ
API キーを作り直したら、反映のしかたが置き場所ごとに違った
Gemini の API キーを作り直したとき、そのキーはその日に見つけただけで4か所の秘密情報に入っていて、新しい値が使われ始める時機がそれぞれ違いました。Firebase の関数はデプロイし直すまで古い版を読み続け、Cloud Run のジョブは次の実行から読み、GitHub の Secrets は中身を見られないので指紋で確かめました。
2026年10月12日、Gemini の API キーを作り直しました。古いキーを消して新しいキーを作る作業は、AI Studio の画面ですぐに終わります。手間がかかったのは、そのキーを使う側でした。キーの置き場所は、AI の作業者の最初の答えでは2つでしたが、4日後までに5つ見つかりました。新しい値が使われ始める時機も、入れ替わったことの確かめ方も、置き場所ごとに違いました。
キーを置いている場所
入れ替えた時点で分かっていたのは、次の4つの仕組みです。
| 使う仕組み | キーの置き場所 | 新しい値が使われ始める時機 |
|---|---|---|
| 過去の小さな AI アプリが共用するサーバー処理(Cloud Functions 第2世代) | Secret Manager | 関数をデプロイし直したとき |
| Chronicle AI の記事の生成(Cloud Run のジョブ) | 別のプロジェクトの Secret Manager | 次の実行から |
| AIBloom の記事の生成(GitHub Actions) | GitHub の Secrets | 値を写したあとの、次の実行から |
| 5秒バトルの AI 審判(Cloudflare Workers) | Cloudflare の秘密情報 | 上書きしたとき |
秘密情報の書き換えと本番のデプロイは私が行い、AI の作業者は手順を示して結果を確かめました。
古いキーは、新しいキーを作ったその日の未明に、AI Studio で消してあります。Secret Manager では、値を書き換えるたびに新しい「版」ができ、古い版も番号つきで残ります。昼の12時13分に共用のサーバー処理の側でバージョン5を、12時15分に Chronicle AI の側でバージョン2を、新しいキーを入れた値で追加しました。
関数は、デプロイした時点の版を読み続ける
共用のサーバー処理の関数は、前にデプロイしたときの版(バージョン4)に固定されていて、デプロイし直さないと新しい版を読みません。版を追加した20分後に「パワーシェルでのキーの置き換え作業みたいなものはないのでしょうか?」と聞いたとき、関数の設定はまだバージョン4でした。キーを入力する作業はもう無く、残っているのはデプロイだけでした。
Firebase CLI は、デプロイのときに「いちばん新しい版」を、その時点の版の番号に置き換えて関数に設定します。使っている firebase-tools 15.6.0 では、次の処理です。
const sv = await (0, secretManager_1.getSecretVersion)(projectId, secret, "latest");
// (中略)
s.version = secretVersions[s.secret].versionId;
そのため、秘密情報に新しい版を足しても、関数は次にデプロイされるまで古い番号を読み続けます。逆に言えば、デプロイし直すまで、書き間違えた値が関数に届くこともありません。
古い版は、デプロイが終わるまで無効にしませんでした。動いている関数が読む先はバージョン4なので、先に無効にすると、新しく起動した関数が秘密情報を読めなくなるおそれがあるためです。
デプロイが10秒の時間切れで止まった
1回目のデプロイは、次のエラーで止まりました。
Error: User code failed to load. Cannot determine backend specification. Timeout after 10000.
Firebase CLI は、デプロイの前に関数のコードを読み込んで、どんな関数があるかを調べます。この読み込みを待つ時間が、既定で10秒です。止まったのはこの確認の段階なので、本番の関数は何も変わっていませんでした。
手元で読み込みの時間を2回測ると、1.3秒と1.2秒でした。待ち時間は環境変数 FUNCTIONS_DISCOVERY_TIMEOUT で延ばせます。CLI の中では値に1000を掛けているので、単位は秒です。
return +(process.env[TIMEOUT_OVERRIDE_ENV_VAR] || 0) * 1000;
PowerShell で $env:FUNCTIONS_DISCOVERY_TIMEOUT = "60" を設定してから実行し直すと、デプロイは通りました。延ばしても止まった回はモデル終了の制作ノートに書いています。12時44〜45分に、このキーを使う11本の関数が作り直され、11本ともバージョン5を読む設定になったことを確かめました。キーを使わない残りの3本は、作り直されずに10月2日のままでした。
Cloud Run のジョブは、次の実行から読む
Chronicle AI の記事の生成は、Cloud Run のジョブとして決まった時刻に動きます。このジョブの設定は、秘密情報を版の番号ではなく「latest」(いちばん新しい版)で読む形です。
Chronicle AI の側は、版を追加しただけで、デプロイはしていません。18時の実行で、秘密情報を問題なく読み込めたことを確かめました。latest で読む設定なので、読んだのは追加した版のはずです。ただ、この回は記事を書かない回で、Gemini は呼んでいないので、新しいキーで呼び出せるかまでは分かりませんでした。手間はかかりませんが、書き間違えた値を追加すると、次の実行からすぐにそれが使われます。関数とは、手間と安全の釣り合いが逆です。
3か所目は GitHub の Secrets だった
その日の夜、AIBloom の公開が最近減っていることに気づき、「もしかしてキー等の処理で間違った対応があった・・?」と尋ねました。調べると、減ったのは週末と祝日でニュースの候補が減ったためで、キーとは関係ありませんでした。
ただ、その途中で、AIBloom が自分用の秘密情報を GitHub の Secrets に持っていて、そこにも同じキーが入っていることが分かりました。最初の答えの「置いてある場所は2つです」は、ここで間違いと分かりました。GitHub の Secrets は Secret Manager とつながっていないので、こちらは版を足しても変わりません。
GitHub の Secrets は、登録した値を後から読み出せません。AIBloom には10月1日に作った確認用のワークフローがあり、キーの値の代わりに、キーから計算した8文字の「指紋」と、モデルごとに呼び出せたかを表示します。指紋からキーに戻すことはできません。
function fingerprint(key) {
return crypto.createHash('sha256').update(key).digest('hex').slice(0, 8);
}
19時38分に確認のワークフローを実行すると、その日に作り直した古いキーが無効(INVALID)と出ました。
入れ替えは、共用のサーバー処理の側のバージョン5を、そのまま写す形にしました。Secret Manager から読み出した値を、画面に出さずにそのまま GitHub に渡します。
gcloud secrets versions access 5 --secret=<秘密情報の名前> --project=<プロジェクト> | gh secret set <秘密情報の名前> --repo <リポジトリ>
19時44分にもう一度確認のワークフローを実行すると、無効の表示は消えました。新しいキーは、試した3つのモデルのどれでも呼び出せました。
4か所目の Cloudflare は、上書きでしか直せない
5秒バトルの配信先の Cloudflare にも、同じキーが入っている可能性がありました。Cloudflare の秘密情報も、登録した値を後から読み出せません。この場所は、最初の答えにも出ていましたが、中身を確かめられないとして数に入っておらず、後回しになっていました。
10月14日の朝、GitHub のときと同じように、共用のサーバー処理の側のバージョン5を、画面に出さずにそのまま上書きしました。
gcloud secrets versions access 5 --secret=<秘密情報の名前> --project=<プロジェクト> | npx wrangler secret put <秘密情報の名前>
Cloudflare では、秘密情報を書き換えるとその場で新しい版が出て、配信の履歴に「Secret Change」として残ります。9時29分の記録を確かめました。値を読み出す方法も指紋を見る仕組みも無いので、ここで見られるのは上書きした記録までです。
5か所目は、4日後に別のツールの失敗から見つかった
10月16日、AI のモデルの終了の通知を受けて、全部のアプリを見直していました。そのとき、定期的に動く別の小さなツール(warp-studio.com からはリンクしていないもの)で、10月12日の朝から「キーが無効」のエラーが出ていると分かりました。このツールも GitHub の Secrets に、作り直す前の古いキーを持っていました。上の表のどこにも入っていない置き場所です。
このツールは10月20日に作り直し、そのときにキーも新しいものに替わりました。10月21日の朝の定期の実行は成功しています。最初の答えの2つも、その日のうちにそろえた4つも、調べた範囲から挙げた数で、どちらも実際の置き場所より少なかったことになります。
古い版は消さずに無効にした
「過去のバージョンは消しておいた方が良いとかありますか?」とも聞きました。古い版に入っている古いキーは、もう使えません。消すのではなく無効にしておけば、間違って古い版に戻すことを防げ、あとで元に戻すこともできます。破棄は戻せません。動作を確かめたあと、その日のうちに、Secret Manager の2か所の古い版をすべて無効にしました。
10月14日の朝の時点の AI Studio の使用量では、新しいキーは入れ替えのあと18回使われていました。キーの値を一度も表示せずに、新しいキーが使われていることを確かめられました。
次に同じことをするときの手順
この日の作業を、次のときのための手順にまとめておきます。
- キーを置いている場所を、先に全部挙げる。そのキーを使っていそうなリポジトリだけでなく、作業フォルダーのすべてのリポジトリと設定を探す
- 新しい版を足したら、関数はデプロイし直し、ジョブは次の実行を待つ。GitHub と Cloudflare の秘密情報には同じ値を写す
- 入れ替わったかは、関数の設定の版の番号、指紋、使用量のグラフで確かめる。キーの値は表示しない
- 急いで止める理由が無ければ、古いキーを消すのは、置き場所をすべて入れ替えてからにする
- 古い版は、動作を確かめてから無効にする。破棄はしない
キーを作り直す作業は数秒で済みますが、そのキーをどこで使っているかを全部挙げられないと、入れ替えは終わりません。今回は最後の1か所が、4日後まで分かりませんでした。値を見ずに確かめる手段(指紋や使用量のグラフ)を先に用意しておいたことに、今回は助けられました。
過去に作った小さな AI アプリは、過去の制作の一覧に載せています。それらを作って分かったことは、小さな AI アプリの記録にまとめました。モデルを替えるときの決まりはモデルを替えるたびに起きたことの制作ノートに、10月16日の全アプリの見直しはモデル終了の通知から全アプリを見直した制作ノートに書いています。