예전 SDK에서 이전하기

예전 코드가 있다면 지금 옮겨

google-generativeai는 2025년 11월에 수명이 끝났어. 아직 설치되고 많은 경우 작동하지만, Google은 더 이상 버그를 고치지 않아. 모델 API가 발전할수록 예전 SDK는 경고 없이 낡아 가. 이전 작업은 대부분 기계적으로 바꿀 수 있으니 한 번에 끝낼 가치가 있어.

API 구조가 달라졌어

두 SDK 사이에서 달라진 지점은 다음과 같아:

항목	예전 SDK(google-generativeai)	새 SDK(google-genai)
패키지	`google-generativeai`	`google-genai`
Import	`import google.generativeai as genai`	`from google import genai`
초기화	`genai.configure(api_key=...)`	`genai.Client(api_key=...)`
모델 객체	`genai.GenerativeModel('...')`	없음 — 호출할 때마다 `model=` 전달
생성	`model.generate_content(text)`	`client.models.generate_content(model=..., contents=...)`
스트리밍	`stream=True` 인자	`generate_content_stream()`
비동기	`generate_content_async()`	`client.aio.models.generate_content()`
채팅	`model.start_chat()`	`client.chats.create(model=...)`
Vertex	별도 `vertexai` 패키지	`Client(vertexai=True)`

안전하게 이전하는 순서

requirements.txt에 google-genai를 예전 패키지와 함께 버전 고정해. 둘은 공존할 수 있어.
get_client() -> genai.Client를 내보내는 새 모듈을 추가해.
호출부를 하나씩 옮겨. model.generate_content(text)를 client.models.generate_content(model=..., contents=text)로 바꿔.
마지막 호출부까지 옮긴 뒤 예전 configure() 호출을 삭제해.
의존성 목록에서 예전 패키지를 제거해.

Code

나란히 비교하기: 가장 흔한 호출·python

# ❌ BEFORE — legacy, EOL
import google.generativeai as genai
genai.configure(api_key='KEY')
model = genai.GenerativeModel('gemini-pro')
response = model.generate_content('Tell me a story.')
print(response.text)

# ✅ AFTER — new SDK
from google import genai
client = genai.Client()
response = client.models.generate_content(
    model='gemini-2.5-flash',
    contents='Tell me a story.',
)
print(response.text)

스트리밍·python

# ❌ BEFORE
response = model.generate_content('Tell me a story.', stream=True)
for chunk in response:
    print(chunk.text, end='')

# ✅ AFTER
for chunk in client.models.generate_content_stream(
    model='gemini-2.5-flash',
    contents='Tell me a story.',
):
    print(chunk.text, end='')

비동기 호출·python

# ❌ BEFORE
response = await model.generate_content_async('Hi')

# ✅ AFTER
response = await client.aio.models.generate_content(
    model='gemini-2.5-flash', contents='Hi')

Exercise

google.generativeai를 쓰는 실제 Python 스크립트나 작은 예제 하나를 찾아. 위 표에 따라 google-genai로 옮기고, 같은 프롬프트로 두 버전을 나란히 실행해. 공통 seed가 없으므로 생성 결과는 다를 수 있지만 내용은 대체로 비슷해야 해. 새 버전이 2024년의 예전 SDK가 아니라 2026년에 제공되는 SDK를 쓰는지 확인해.