Gemini APIを活用したアプリケーション作成

Gemini Keyの発行

Google Gemini APIを使用するには、API Keyを発行する必要がある。

1. Gemini Developer APIサイトにアクセス

• https://ai.google.dev/ にアクセスし、Explore models in Google AI Studioボタンをクリックする。
• 初回アクセス時は利用規約が表示されるため、内容を確認して「Continue」ボタンをクリックする。

2. Get API Keyの発行

• Get API Keyメニューを選択すると、Keyを発行できる。
• すでに発行済みなら一覧に表示され、発行したことがなければAPIキーを作成ボタンで発行できる。

無料枠

無料枠はモデルごとに使用量制限がある。 gemini-3-flash基準で、1日の最大リクエスト数（RPD）は最大20回しかない。

ライブラリを活用したクライアント開発

ここではKotlin言語でGoogle GenAI SDKを活用し、APIを呼び出す方法を見ていく。

プロジェクト作成

IDEツールを利用してプロジェクトを作成する。

.
├── build.gradle.kts
├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle.kts
└── src
    ├── main
    │   ├── kotlin
    │   │   └── Main.kt
    │   └── resources
    └── test
        ├── kotlin
        └── resources

ライブラリ追加

/build.gradle.kts

dependencies {
    implementation("com.google.genai:google-genai:1.36.0")
}

• バージョンはGitHubリポジトリ（googleapis/java-genai）を確認し、最新バージョンを入れればよい。

クライアント開発

/src/main/kotlin/Main.kt

package com.devkuma

import com.google.genai.Client

fun main() {
    val client = Client.builder().apiKey("GEMINI_API_KEY").build()

    val response =
        client.models.generateContent(
            "gemini-3-flash-preview",
            "人工知能について一文で説明してください。",
            null
        )

    println(response.text())
}

Output:

人工知能は、人間の学習、推論、知覚能力をコンピューターシステムで実装し、機械が知的な作業を実行できるようにする技術です。

• GEMINI_API_KEYには発行したキーを入れる。

REST

Gemini APIはREST APIとして呼び出すこともできる。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "人工知能について一文で説明してください。"
          }
        ]
      }
    ]
  }'

output:

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "人工知能は、人間の学習、推論、知覚能力をコンピューターシステムで実装し、知的な作業を実行できるようにした技術です。",
            "thoughtSignature": "Er8OCrwOAXLI2nzqxL3K8LCAB020BPaY+sv89...."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 13,
    "candidatesTokenCount": 32,
    "totalTokenCount": 415,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 13
      }
    ],
    "thoughtsTokenCount": 370
  },
  "modelVersion": "gemini-3-flash-preview",
  "responseId": "5rh6afO6NYb22roPsKr06Ao"
}

参考文書

• Gemini API | Google AI for Developers

上記のサンプルコードはGitHubで確認できる。