Molayo

© 2026 Molayo

Qiita헤드라인2026. 06. 23. 01:39

Google Gemini Interactions API 정식 GA 발표——통합 인터페이스로 최신 모델에 접속하는 방법

요약

Google이 Gemini 모델 및 에이전트와 대화하기 위한 통합 인터페이스인 Gemini Interactions API의 정식 GA(General Availability)를 발표했습니다. 개발자는 이제 일관된 방식으로 최신 모델과 기능에 액세스할 수 있으며, 기존 구현의 재검토가 권장됩니다.

핵심 포인트

  • Gemini 모델 및 에이전트 접속을 위한 통합 인터페이스 제공
  • 기존 베타/프리뷰 단계에서 정식 GA 버전으로 전환
  • total_reasoning_tokens 필드 명칭 변경 등 파괴적 변경 사항 확인 필요
  • 최신 기능 및 모델 활용을 위해 Interactions API 사용 권장

2026년 6월 22일, Google은 Gemini Interactions API의 일반 제공(GA: Generally Available)을 정식으로 발표했습니다.

지금까지 베타 버전 및 퍼블릭 프리뷰(Public Preview)로 제공되었던 이 API가 정식 버전이 되었으며, Google은 "최신 모든 기능과 모든 모델에 액세스하려면 Interactions API를 사용할 것을 권장한다"라고 명시했습니다.

Gemini API를 사용하는 애플리케이션 개발자 및 AI 에이전트 구축자에게 있어, 향후 표준적인 액세스 경로가 확정되었다는 중요한 분기점입니다. 기존 구현을 재검토할 타이밍으로 삼으시기 바랍니다.

📌 영향을 받는 대상

  • Gemini API를 사용하여 애플리케이션을 개발하고 있는 분
  • AI 에이전트나 자동화 파이프라인을 Gemini 모델로 구축하고 있는 분
  • Google AI Studio나 Vertex AI를 통해 Gemini를 이용하고 있는 개발자
  • MCP(Model Context Protocol)를 활용한 에이전트 구성을 검토하고 있는 분

이번 변경은 "Interactions API의 GA"를 중심으로 관련 공지 및 이력이 정리되었습니다.

항목내용
변경 유형기능 발표 (높은 중요도)
대상 APIInteractions API
상태 변경Beta / Public Preview → Generally Available (GA)
권장도Google이 최신 기능 및 모델 액세스에 권장한다고 명시
대응 긴급도확인 필요 (기존 구현 재검토 권장)

Interactions API는 Gemini 모델 및 에이전트와 대화하기 위한 통합 인터페이스를 제공합니다. 여러 Gemini 모델이나 에이전트를 다룰 때, 개별 API를 각각 호출할 필요 없이 일관된 방법으로 액세스할 수 있게 됩니다.

상단에 게재되어 있던 다음 공지가 삭제되었습니다.

"Gemini Deep Research is now available in preview with collaborative planning, visualization, MCP support, and more."

이는 Interactions API GA 공지로의 **교체(Rotation)**에 의한 것이며, Deep Research 기능 자체가 폐지된 것은 아닙니다. MCP 지원이나 협업적 플래닝(Collaborative Planning)·시각화와 같은 기능은 계속 이용 가능할 것으로 보입니다.

GA화에 따라 과거 변경 이력 항목이 업데이트되었습니다.

날짜변경 전변경 후
2025년 12월 19일"Introduced a breaking change to the Interactions API public preview in v1beta""Introduced a breaking change to the Interactions API in v1beta"
2025년 12월 11일"Launched the Interactions API in Beta.""Launched the Interactions API."

"Beta", "public preview"라는 단어가 삭제되어 정식 버전을 전제로 한 표현으로 통일되었습니다. 또한, total_reasoning_tokens 필드의 이름 변경을 포함한 파괴적 변경(Breaking Change) 기록 자체는 유지되고 있습니다.

즉시 확인해야 할 사항:

  • total_reasoning_tokens 필드를 사용 중인 경우
    2025년 12월 19일의 파괴적 변경으로 필드명이 변경되었습니다. GA 버전에서는 변경된 명칭이 정식이 되므로, 코드를 확인하고 수정하십시오.
  • Gemini API를 독자적인 엔드포인트로 호출하고 있는 경우
    Interactions API로의 이전을 검토하십시오. Google이 최신 기능 및 모델에 대한 액세스 경로로 권장하고 있습니다.
  • AI 에이전트를 구축하고 있는 경우
    Interactions API는 에이전트와의 대화에도 대응하는 통합 인터페이스입니다. 에이전트 연동 구현을 재검토하는 기회로 활용할 수 있습니다.
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
# 개별 모델을 지정하여 직접 호출
...

from google import genai
client = genai.Client(api_key="YOUR_API_KEY")
# Interactions API를 사용한 통합 인터페이스 호출
...

💡 Tips

google-genai SDK(from google import genai)는 Interactions API를 지원하는 새로운 클라이언트입니다. 기존의 google-generativeai(import google.generativeai as genai)에서 마이그레이션할 때는 패키지도 업데이트해 주세요.

from google import genai
from google.genai import types
client = genai.Client(api_key="YOUR_API_KEY")
...

⚠️ Breaking Change

v1beta에서 total_reasoning_tokens 필드가 리네임되었습니다. 이 필드를 참조하고 있는 코드는 GA 버전의 공식 문서를 통해 정식 필드명을 확인한 후 수정하시기 바랍니다.

비교 항목기존 개별 APIInteractions API (GA)
대응 범위모델별 개별 대응Gemini 전 모델 + 에이전트 통합
최신 기능 액세스기능에 따라 API 분산단일 엔드포인트로 최신 기능 대응
에이전트 연동별도 구현 필요네이티브 지원
MCP 지원제한적지원 (Deep Research 등)
Google 권장도마이그레이션 권장공식 권장
상태레거시화 가능성 있음GA (정식 버전)

이번 발표의 핵심 포인트를 정리합니다.

  • Interactions API가 GA (General Availability)로 출시 — Gemini 모델 및 에이전트와 대화하는 통합 인터페이스로서 정식 출시
  • Google이 최신 기능 및 모델에 대한 액세스 경로로 Interactions API를 권장 — 신규 개발 시 Interactions API를 기본으로 사용해야 함
  • v1beta의 파괴적 변경 (Breaking Change) — 기존 코드 확인 필요 (total_reasoning_tokens 리네임) 사항이 GA 버전으로 계승됨
  • Gemini Deep Research 기능 (MCP, 협력적 플래닝, 시각화)은 계속 이용 가능 — 상단 공지 내용의 변경은 기능 폐지를 의미하지 않음

Gemini를 사용한 개발의 '표준 액세스 경로'가 Interactions API로 집약된 지금이 기존 구현을 재검토할 절호의 타이밍입니다. GA 출시로 인해 API 안정성도 향상되었으므로, 프로덕션 환경 도입을 적극적으로 검토할 수 있는 단계에 진입했습니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0