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 기준으로 일일 최대 요청 수(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에서 확인해 볼 수 있다.