Gemini API使い方【2026年最新】5分でわかる初期設定

2026年4月26日 2026年4月27日

Shinomi

Gemini APIとは？できることを30秒で理解する

Gemini API は、Google が提供する生成AI（大規模言語モデル）をプログラムから呼び出すためのインターフェース。テキスト生成・画像認識・コード生成・マルチモーダル入力まで、ひとつのAPIで幅広く対応している。

アクセス経路は大きく2つある。Google AI Studio（個人・開発者向け・手軽）と Vertex AI（エンタープライズ・GCP連携）だ。この記事では Google AI Studio 経由を前提に進める。筆者も最初は Vertex AI の画面に迷い込んでロスタイムしたので、初心者は迷わず AI Studio から始めてほしい。

Gemini 全体の概要や活用法については → Gemini 使い方完全ガイドでまとめているので、APIの前に基本を抑えたい方はそちらへ。

【2026年最新】APIキーの取得手順（5分で完了）

「APIキー取得ってむずかしそう」と思っていたら、実際には 5 分かからなかった、というのが正直な感想。手順どおりに進めれば詰まるところはほぼない。

ステップ1：Google AI Studioにアクセス・ログイン

ブラウザで aistudio.google.com を開く
Googleアカウントでログイン（無料アカウントでOK）
初回は利用規約への同意画面が出るので確認してチェックを入れる

ステップ2：APIキーを作成・コピーする

左サイドメニューの 「Get API Key」 をクリック
「Create API Key」 ボタンを押す
新規プロジェクトを作るか、既存の GCP プロジェクトを選択する
発行されたキーをパスワードマネージャーなど安全な場所にコピー保存する

⚠️ キーは発行直後しかフル表示されない。コピーし忘れたら再発行が必要。

ステップ3：APIキーの動作確認（curlコマンド）

取得したらすぐに動作確認しよう。ターミナルで以下を実行する。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

YOUR_API_KEY を実際のキーに置き換えて実行。candidates を含む JSON が返ってきたら成功。API_KEY_INVALID が返ったら次のエラー対処セクションを確認してほしい。

APIキーの安全な管理方法3選

GitHubに誤ってAPIキーを push して課金が爆発した、という話は笑えない実話だ。筆者も過去に別サービスのキーを public リポジトリに上げてしまい、即座に無効化対応した経験がある。最初に正しい管理を身につけておけば怖くない。

環境変数で管理する方法（Mac / Windows / Linux）

export GEMINI_API_KEY="your_api_key_here"

$env:GEMINI_API_KEY="your_api_key_here"

Python から読み込む場合は os.environ.get("GEMINI_API_KEY") の 1 行で取得できる。

.envファイル + .gitignoreで管理する方法

プロジェクトルートに .env ファイルを作成する。

GEMINI_API_KEY=your_api_key_here

pip install python-dotenv でライブラリを入れたあと、コード冒頭に load_dotenv() を呼ぶだけ。.gitignore に .env の 1 行を追加して、絶対に Git 管理対象に入れないようにすること。

Google Cloud ConsoleでAPIキーに利用制限をかける方法

Google Cloud Console の「認証情報」画面でキーを選択し、以下を設定できる。

IPアドレス制限：特定のサーバーIPからしか使えないようにする
APIの制限：Gemini API だけに絞る

万が一キーが漏洩しても被害を最小限に抑えられる。この設定、最初は面倒に感じるけど 5 分で終わるのでやっておいて損はない。

【言語別】SDK・ライブラリのインストールと最初のAPI呼び出し

Pythonでの実装（google-genaiライブラリ）

pip install google-genai

import os
from google import genai

client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY"))
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="日本の首都はどこですか？"
)
print(response.text)

response.text でテキスト部分だけ取り出せる。筆者はこの 10 行以内のコードを雛形にして、用途ごとにプロンプトを差し替える使い方をしている。

JavaScript（Node.js）での実装

npm install @google/genai

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "日本の首都はどこですか？",
  });
  console.log(response.text);
}
main();

async/await で書くとコードがすっきりする。Node.js 18 以上であれば追加設定なしで動く。

REST API（curl）での実装

SDK を入れずに直接 HTTP リクエストを叩く方法。Go・Java・PHP など、SDK が用意されていない言語でも使える。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"日本の首都はどこですか？"}]}]}'

リクエストボディは contents → parts → text の構造が基本形だ。

【2026年4月版】利用可能なモデル一覧と選び方

2026年4月時点で主要なモデルをまとめた。

モデル	無料利用	推奨ユースケース
Gemini 2.5 Flash	○（無料）	汎用・高速・コスト重視
Gemini 2.5 Pro	○（低レートリミット）	高精度・複雑な推論
Gemini 2.0 Flash	⚠️ 2026年6月1日廃止予定	移行推奨

初心者は Gemini 2.5 Flash からスタートが正解。 無料で使え、レスポンスも速い。精度が足りないと感じたら 2.5 Pro に切り替えればいい。

Gemini 2.0 Flash は2026年6月1日にシャットダウン予定なので、すでに使っている方は早めに移行してほしい。

料金体系と無料枠の制限【概要】

2026年4月1日から課金ティア制度が強制適用された。月間支出がティア上限に達すると API リクエストが自動停止する仕組みになっている。

ティア	月間上限
Tier 1	$250
Tier 2	$2,000
Tier 3	$20,000〜

Gemini Flash モデルは引き続き無料で利用可能。ただし Gemini 2.5 Pro を含む Pro シリーズは無料枠から除外され、有料ユーザー専用になった点は要注意だ。また新規ユーザーは前払い課金が必須化されている。

個人開発・学習用途なら Flash の無料枠で十分なケースがほとんど。詳細な料金設定や課金方法は → Gemini 料金完全解説で別途まとめている。最新情報は必ず公式料金ページで確認してほしい。

Gemini API実装でよくあるエラーと対処法

APIキー関連のエラー（400 / 403）

API_KEY_INVALID が返ってくる主な原因は3つ。

キーに余分なスペースや改行が混入している
キーが有効化される前にリクエストを送った（発行直後は数分待つ）
EEA（欧州経済領域）・UK・スイスなどリージョン制限のある地域からアクセスしている

リージョン制限に引っかかると、VPN などを使わない限り解決できない。海外在住の方は注意が必要だ。

レートリミット・クォータ超過エラー（429）

無料枠の RPM・TPM 上限に達したときに発生する。一時的な対処はリトライ処理で乗り切れる。

import time

for attempt in range(5):
    try:
        response = client.models.generate_content(...)
        break
    except Exception as e:
        wait = 2 ** attempt  # 1, 2, 4, 8, 16秒
        time.sleep(wait)

指数バックオフでリトライ間隔を広げるのが定番。頻繁に 429 が出るようなら有料プランへの切り替えを検討するタイミングだ。