知識專欄
Google Gemini API 金鑰申請全流程：三個官方沒寫、但一定會卡住的地方
最近替「AI名片王」的使用者寫申請說明，我把 Google Gemini API 金鑰的申請流程從頭到尾自己跑過一遍，每一步都截了圖。過程中遇到三個官方說明沒有提、但實際操作幾乎一定會卡住的地方，先寫在這裡。
一、全新帳號在 AI Studio 根本建不出金鑰
在 Google AI Studio 按下「Create API key」之後，專案下拉選單會顯示「No Cloud Projects Available」——因為新帳號名下還沒有任何 Google Cloud 專案。選單裡雖然看得到「Create project」，但實測按下去會失敗，跳出「Unable to create API key」，要你自己去 Google Cloud 主控台建立專案。所以正確做法是先離開 AI Studio，到 Cloud Console 把專案建好再回來。
二、Cloud Console 建好的專案，不會自動出現在 AI Studio
這是最多人卡住的一步。專案明明建好了，回到 AI Studio 的下拉選單卻找不到它。AI Studio 不會自動列出帳號底下所有的 Cloud 專案，必須點選單裡的「Import project」手動匯入一次，之後它才會固定出現在清單中。
三、新版金鑰是 AQ. 開頭，不是 AIza
網路上多數教學的截圖裡，金鑰都是 AIza 開頭。Google 已經改用新的格式，現在新申請的金鑰是 AQ. 開頭。兩種都是有效金鑰，但如果你的程式對金鑰做了「必須 AIza 開頭」的格式檢查，新申請的金鑰會被自己的程式擋掉。
另外兩件值得知道的事
- Google AI Studio 只有英文介面，沒有語言切換；Google Cloud 主控台則有十種介面語言。所以同一份教學裡，前半段的畫面是英文、後半段會跟著你的語言變，這不是截圖弄錯了。
- 自動化操作會被風控擋下。用程式去點「Create key」會收到「The request is suspicious」，真人手動按同一顆按鈕則正常。想寫腳本一鍵申請的人可以省下這個力氣。
完整圖解教學
整個流程共十個步驟，每一步都有截圖並用紅框標出要點擊的位置，另外附上免費額度說明、金鑰保管注意事項與疑難排解。教學提供十種語言，會依照瀏覽器語言自動切換。
順帶一提，會寫這份教學是因為「AI名片王」採用使用者自備金鑰的設計：名片內容直接從使用者的手機送到他自己申請的 AI 服務，不經過我們的伺服器，所以每位使用者都需要自己的一把金鑰。