[Google AI Studio 완전 정복] 3. 내 코드에 Gemini AI 심기 (API 연동 기초)

 

안녕하세요! 'Google AI Studio 완전 정복' 시리즈, 어느덧 3회차입니다.

 

1회차에서는 AI Studio와 처음 만나 인사를 나눴고, 2회차에서는 3가지 프롬프트 유형을 활용해 AI를 멋지게 조련하는 법을 배웠습니다. 이제 여러분의 AI Studio 안에는 꽤 근사한 프롬프트들이 만들어져 있을 겁니다.

 

하지만 이런 생각, 들지 않으셨나요?

 

"이 좋은 기능을 언제까지 여기서만 써야 하지? 내 블로그나, 내가 만드는 앱에 바로 붙여서 쓰고 싶은데..."

 

바로 그 질문에 대한 해답이 오늘 포스팅의 주제입니다. 오늘은 AI Studio라는 놀이터를 벗어나, 우리가 만든 AI 기능을 세상 밖으로 꺼내는 마법의 열쇠, API 연동에 대해 알아봅니다. '개발', '코드' 같은 단어에 겁먹지 마세요! AI Studio가 얼마나 친절하게 모든 과정을 떠먹여 주는지 알게 되실 겁니다.

 

 

1. API, 그게 대체 뭔가요? (식당 종업원 비유)

API(Application Programming Interface)라는 단어만 들으면 머리가 지끈거리는 분들을 위해 비유를 들어볼게요.

우리가 레스토랑에 가서 맛있는 스테이크를 먹고 싶다고 상상해 보세요.

• 나 (손님): 스테이크를 주문하고 싶다.
• 주방 (AI 모델): 스테이크를 요리하는 곳.
• 종업원 (API): 손님의 주문(요청)을 주방에 전달하고, 완성된 요리(결과)를 손님에게 가져다주는 역할.

우리는 주방이 어떻게 돌아가는지, 스테이크를 어떻게 굽는지 몰라도 됩니다. 그냥 '종업원'에게 제대로 주문만 하면 되죠.

API 연동이란, 바로 내 서비스(앱, 웹사이트)가 손님이 되어, AI Studio의 AI 모델(주방)에게 API(종업원)를 통해 원하는 것을 요청하고 그 결과를 받아오는 과정 전체를 의미합니다.

 

2. 마법의 열쇠, API 키 발급받기

우리 식당의 종업원이 아무 손님에게나 음식을 가져다주지 않듯, Google AI도 인증된 사용자에게만 AI 기능을 제공합니다. 이때 필요한 것이 바로 'API 키(Key)', 즉 나만 사용할 수 있는 비밀 열쇠입니다.

 

발급 방법은 정말 간단합니다.

1. Google AI Studio 화면 왼쪽 메뉴에서 Get API key 버튼을 클릭합니다.
2. 새로운 페이지로 이동하면, Create API key in new project 라는 파란색 버튼이 보일 겁니다. 클릭해 주세요.
3. 잠시 기다리면 알파벳과 숫자가 길게 조합된 문자열이 생성됩니다. 이것이 바로 여러분의 소중한 API 키입니다!

 

 

⚠️ 매우 중요!
이 API 키는 여러분의 집 현관문 비밀번호와 같습니다. 절대로 외부에, 특히 블로그나 Github 같은 공개된 공간에 노출해서는 안 됩니다. 메모장이나 안전한 곳에 잘 복사해두세요.

 

3. AI Studio의 숨은 치트키, '코드 보기' 기능

자, 이제 열쇠도 얻었으니 문을 열어봐야겠죠? "이제부터 복잡한 코딩 시작인가..." 싶으셨다면, AI Studio의 가장 위대한 기능을 만날 시간입니다.

 

바로 < > 코드 보기 (Get code) 기능입니다!

 

이 기능은 우리가 지금껏 공들여 만든 프롬프트(2회차에서 만든 이메일 생성기, 광고 카피 생성기 등)를 실제 프로그래밍 언어에서 어떻게 호출해야 하는지 코드를 '자동으로' 생성해 줍니다. 우리가 할 일은 그저 이 코드를 복사해서 붙여넣는 것뿐입니다.

1. 2회차에서 만들었던 Freeform 또는 Structured 프롬프트 화면으로 돌아가세요.
2. 화면 오른쪽 위에 있는 < > Get code 버튼을 클릭합니다.

1. 클릭하면 Python, JavaScript, Curl 등 다양한 언어별 코드가 짠! 하고 나타납니다.

# To run this code you need to install the following dependencies:
# pip install google-genai

import base64
import os
from google import genai
from google.genai import types


def generate():
    client = genai.Client(
        api_key=os.environ.get("GEMINI_API_KEY"),
    )

    model = "gemini-2.5-pro"
    contents = [
        types.Content(
            role="user",
            parts=[
                types.Part.from_text(text="""INSERT_INPUT_HERE"""),
            ],
        ),
    ]
    generate_content_config = types.GenerateContentConfig(
        thinking_config = types.ThinkingConfig(
            thinking_budget=-1,
        ),
    )

    for chunk in client.models.generate_content_stream(
        model=model,
        contents=contents,
        config=generate_content_config,
    ):
        print(chunk.text, end="")

if __name__ == "__main__":
    generate()

 

보세요! 우리가 AI에게 지시했던 "이메일 초안을 작성해줘..." 같은 내용이 코드 안에 그대로 들어가 있는 것을 확인할 수 있습니다. 이제 이 코드를 가져다가 내 서비스에 붙여넣기만 하면 됩니다.

 

4. Python으로 간단하게 AI 연동해보기 (실전 예제)

백문이 불여일견! 가장 많이 사용되는 Python 언어를 이용해 방금 얻은 코드를 직접 실행해 보겠습니다. (컴퓨터에 Python이 설치되어 있어야 합니다. 설치 방법은 검색을 참고해 주세요!)

1. 라이브러리 설치: 먼저 터미널(Windows의 경우 cmd 또는 PowerShell)을 열고 아래 명령어를 입력해 구글 AI 라이브러리를 설치합니다.
   

       pip install -q -U google-generativeai
     

2. 코드 파일 생성: test_ai.py 라는 이름으로 파이썬 파일을 하나 만듭니다.
3. 코드 복사 및 수정:
   • AI Studio의 Get code 팝업창에서 Python 탭을 선택하고 코드를 전체 복사합니다.
   • test_ai.py 파일에 붙여넣습니다.
   • 코드 윗부분에 YOUR_API_KEY 라고 적힌 부분을 2번 단계에서 발급받았던 나만의 API 키로 바꿔줍니다. (따옴표는 그대로 유지하세요!)
   
   

       # test_ai.py
   
   import google.generativeai as genai
   
   genai.configure(api_key="여기에_여러분의_API_키를_붙여넣으세요")
   
   # Set up the model
   generation_config = {
     "temperature": 0.9,
     "top_p": 1,
     "top_k": 1,
     "max_output_tokens": 2048,
   }
   
   # ... (Get code로 복사한 나머지 코드) ...
   
   prompt_parts = [
     "다음 주에 진행할 '신제품 마케팅 전략 회의' 참석 요청 이메일 초안을 작성해줘.... (이하 생략)"
   ]
   
   response = model.generate_content(prompt_parts)
   print(response.text)
     

4. 실행: 터미널에서 아래 명령어로 파일을 실행합니다.
   
    

       python test_ai.py
     

5. 결과 확인: 잠시 후, AI Studio 웹사이트에서 봤던 것과 똑같은 이메일 초안이 여러분의 컴퓨터 화면(터미널)에 출력되는 것을 확인할 수 있습니다!

축하합니다! 여러분은 드디어 AI Studio의 AI 기능을 여러분의 컴퓨터로 불러오는 데 성공했습니다. 이제 이 원리를 응용하면, 웹사이트의 버튼을 눌렀을 때 글을 요약해 주거나, 앱에서 사용자의 질문에 답변해 주는 기능을 직접 만들 수 있게 된 것입니다.

 

마무리하며

오늘은 AI Studio의 기능에 날개를 달아주는 API 연동의 첫걸음을 떼어 보았습니다. API 키를 발급받고, 마법 같은 '코드 보기' 기능을 통해 복잡한 코딩 없이도 내 서비스와 AI를 연결하는 방법을 배웠습니다.

 

처음에는 낯설 수 있지만, "AI가 만들어준 코드를 복사해서, 내 키만 넣고 실행하면 된다"는 큰 그림만 이해하셨다면 오늘 목표는 120% 달성입니다.

 

대망의 마지막 4회차에서는 AI의 결과물을 더욱 섬세하게 다듬는 고급 기능(모델 파라미터, 안전 설정)과, 나만의 데이터를 학습시켜 특정 작업에 고도로 특화된 AI를 만드는 '튜닝(Tuning)'의 개념까지! AI Studio를 전문가처럼 사용하는 비법을 대방출할 예정이니 끝까지 함께해 주세요.