Vertex AI / Google Cloud API をサーバーで使うときに必要な設定
認証
トラブルシューティング
GCP
Vertex AI
Vertex AI や Google Vision など GCP の API をサーバー(非ローカル)で呼ぶ際は、Project ID だけでは不足。以下が揃って初めて動く。
- 有効な GCP Project ID(ダミー値不可)
- サービスアカウント認証(JSON キーを環境変数や SSM で注入)
- そのプロジェクトで対象 API(Vertex AI API など)を有効化
- サービスアカウントに対象 API を呼べる IAM 権限を付与
- 複数 API を使う機能(例: 画像読み取りで Vision + Vertex)は同じ SA で両方使えるか確認
エラーで project dummy のような初期(ダミー)値が出ている場合は、API 未有効よりも「実行時にダミー値が渡っている」可能性が高いので、まず設定値を最優先で確認する。また location など一部の値がコード固定のことがあるため参照範囲を読んで確認する。