# spring boot(java) 제미나이(Gemini) API 연동하기 (무료 버전)

+ (25.10.13) 버전이 업그레이드된 이후 API 호출 주소가 변경된 것 같다.

확인해 보니 기존 API키도 모두 삭제되었다.

https://ai.google.dev/gemini-api/docs/quickstart?hl=ko

Gemini API 빠른 시작 | Google AI for Developers

개발자를 위한 Gemini API 시작하기

ai.google.dev

해당 사이트에 접속하면 연동 방법이 자세히 안내되어있다.

아래 코드를 참고하면서 새 API 주소로 테스트해보면 될 것 같다.

뭔가 AI챗봇을 만들어보고싶어서

개인적으로 만들어놓은 다이어리에 어떤기능을 넣어볼까하다가

단어장에 번역기 기능을 넣으면 좋겠다 생각해서

제미나이가 번역해주는 번역기를 추가해보았다.

원래는 GPT쨩을 쓰고싶었지만 ㅠㅠ 유료로 바뀌어서..

무료키라...응답도느리고..그렇지만..무료니까............

번역기는 안에 내용이 부끄러우니까 다른 예시코드로..

간단하게 테스트해보는 코드를 만들어보겠다.

먼저 제미나이 api키를 발급받아야 한다.

https://aistudio.google.com/apikey

로그인 - Google 계정

이메일 또는 휴대전화

accounts.google.com

여기서 로그인을 한 후 API키를 무료로 발급받으면 되고 이게 끝이 아니라

제미나이 api를 활성해주어야 비로소 사용이 가능하다.

https://console.cloud.google.com/apis/

Google 클라우드 플랫폼

로그인 Google 클라우드 플랫폼으로 이동

accounts.google.com

그건 여기에서 로그인을 한다음

gemini api를 선택해주고

아마 버튼이 있을텐데 활성이였는지 사용이었는지 기억이 안나지만

그 버튼을 눌러주면

짜잔 이렇게 변한다.

이러면 이제 gemini api를 사용할 수 있게 된것이다.

아까 봤던 get api key사이트에 들어가보면

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H 'X-goog-api-key: GEMINI_API_KEY' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

이런식으로 사용방법이 나와있다.

그대로 postman에서 확인해보면 응답이 어떻게 오는지 알수있을것이다.

자이제 api 키로 제미나이와 얘기도 해봤겠다 본격적으로 연동을 해보자.

build.gradle에 해당 라이브러리를 추가해준다.

implementation 'org.springframework.boot:spring-boot-starter-webflux'

Spring 비동기 HTTP 클라이언트다.

대충 이런 역할이라고 한다.

spring-boot-starter-webflux는 WebClient 를 쓰기 위해 필요한 의존성
REST API 요청을 비동기로 날리고, 응답을 이벤트처럼 받음 (성능 효율적)

application.properties에도 api key를 넣어준다.

# Gemini KEY
gemini.api.key=YOUR_KEY

GeminiSimpleController

@RestController
public class GeminiSimpleController {
    private final WebClient webClient = WebClient.create("https://generativelanguage.googleapis.com");

    @Value("${gemini.api.key}")
    private String apiKey;

    @PostMapping("/gemini/simple")
    public Mono<String> callGemini(@RequestBody String input) {
        Map<String, Object> body = Map.of(
            "contents", List.of(Map.of(
                "parts", List.of(Map.of("text", "간단히 대답해줘:\n\n" + input))
            ))
        );

        return webClient.post()
            .uri(uriBuilder -> uriBuilder
                .path("/v1beta/models/gemini-1.5-flash-latest:generateContent")
                .queryParam("key", apiKey)
                .build())
            .contentType(MediaType.APPLICATION_JSON)
            .bodyValue(body)
            .retrieve()
            .bodyToMono(String.class);
    }
}

TestController

package org.example.test.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class TestController {

    @GetMapping("/test")
    public String test() {
        return "test";
    }
}

test.html (타임리프)

<!DOCTYPE html>
<html lang="ko" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Gemini 테스트</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="/css/output.css" rel="stylesheet" th:href="@{/css/output.css}">
</head>
<body class="bg-gray-100 min-h-screen p-6">

<div class="max-w-md mx-auto bg-white p-6 rounded shadow space-y-4">
    <h1 class="text-xl font-bold text-center text-gray-800">Gemini 간단 테스트</h1>
    
    <!-- 입력 폼 -->
    <form id="chat-form" class="flex gap-2">
        <input type="text" id="chat-input" class="flex-1 border rounded p-2" placeholder="질문 입력..." required>
        <button type="submit" class="bg-blue-500 text-white px-4 py-2 rounded hover:bg-blue-600">보내기</button>
    </form>
    
    <!-- 채팅 박스 -->
    <div id="chat-box" class="h-64 overflow-y-auto border rounded p-3 bg-gray-50 space-y-2 text-sm">
        <!-- 메시지 출력됨 -->
    </div>
</div>

<script th:inline="javascript">
    const form = document.getElementById("chat-form");
    const input = document.getElementById("chat-input");
    const chatBox = document.getElementById("chat-box");
    
    form.addEventListener("submit", async (e) => {
        e.preventDefault();
        
        const userMsg = input.value.trim();
        if (!userMsg) return;
        
        appendMessage("나", userMsg);
        input.value = "";
        
        try {
            const res = await fetch(/*[[${'/gemini/simple'}]]*/ "/gemini/simple", {
                method: "POST",
                headers: { "Content-Type": "application/json" },
                body: JSON.stringify(userMsg)
            });
            
            const data = await res.text();
            appendMessage("Gemini", data);
        } catch (err) {
            appendMessage("Gemini", "(에러 발생: " + err.message + ")");
        }
    });
    
    function appendMessage(sender, message) {
        const div = document.createElement("div");
        div.innerHTML = `<strong>${sender}:</strong> <div class="whitespace-pre-line">${message}</div>`;
        chatBox.appendChild(div);
        chatBox.scrollTop = chatBox.scrollHeight;
    }
</script>

</body>
</html>

결과화면

만약 text만 파싱해서 안녕하세요!만 깔끔하게 추출하고싶으면

const data = await res.text();
let reply = "(응답 형식이 이상합니다)";
try {
    const json = JSON.parse(data);
    const text = json.candidates?.[0]?.content?.parts?.[0]?.text;
    if (text) reply = text;
} catch (err) {
    reply = "(JSON 파싱 실패)";
}
appendMessage("Gemini", reply);

이런식으로 파싱해서 넣으면 된다~

'🗄️ 백엔드 > 🍃Spring' 카테고리의 다른 글

# GitHub API로 커밋 히스토리 불러오기 (Spring Boot REST API 연동) (2)	2025.08.27
# Spring Security + Thymeleaf: 로그인 사용자 활용하기 (3)	2025.08.25
# spring boot(gradle) google로그인(소셜 로그인) 연동 방법 3탄(배포된 사이트) (1)	2025.07.10
# spring boot(gradle) google로그인(소셜 로그인) 연동 방법 2탄 (1)	2025.07.08
# spring boot(gradle) google로그인(소셜 로그인) 연동 방법 1탄 (4)	2025.07.07

일	월	화	수	목	금	토
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

📒솜이노트