오늘 저희는 Interactions API 가 일반 공급(GA)에 도달했으며, 이제 Gemini 모델 및 에이전트와 상호작용하기 위한 주요 API 가 되었음을 알려드려요. 2025 년 12 월에 공개 베타를 시작했으며, 개발자들이 Gemini로 애플리케이션을 구축하는 가장 선호하는 방식이 되었어요.
이번 GA 릴리스로 API 는 안정적인 스키마를 가지게 되었으며, 개발자들이 요청한 중요한 새 기능(Managed Agents, 백그라운드 실행, 곧 제공될 Gemini Omni 등)도 추가했어요. 모든 문서는 이제 Interactions API 를 기본으로 사용하며, 생태계 파트너와 협력하여 3P SDK 및 라이브러리에서 기본 인터페이스로 만들고 있어요.
Gemini로 구축하는 가장 간단한 방법
모델을 호출하든 에이전트를 실행하든, Interactions API 를 사용하면 몇 줄의 코드로 작업을 수행할 수 있어요. 추론을 위해 모델 ID 를 전달하거나 자율 작업을 위해 에이전트 ID 를 전달하고, 장기 실행 작업에는 background=True 를 설정하세요.
1from google import genai23client = genai.Client()45# 모델과 대화6interaction = client.interactions.create(7 model="gemini-3.5-flash",8 input="양자 얽힘을 간단히 설명해 줘.",9)1011# 에이전트 실행12interaction = client.interactions.create(13 agent="antigravity-preview-05-2026",14 input="전 세계 태양 에너지 발전 성장을 그래프로 그리고 HTML 로 슬라이드 몇 개 만들어 줘.",15 environment="remote",16)
12 월 이후 주요 업데이트
- Managed Agents: 단일 API 호출로 원격 Linux 샌드박스가 프로비저닝되어 에이전트가 추론, 코드 실행, 웹 검색, 파일 관리를 할 수 있어요. Antigravity 에이전트가 기본으로 제공되며, 나만의 커스텀 에이전트를 지침, 기술, 데이터 소스와 함께 정의할 수 있어요.
- Background execution: 모든 호출에 background=True 를 설정하세요. 서버가 상호작용을 비동기적으로 실행해요.
- Tool improvements: 내장 도구 (Google 검색, Google Maps)와 자체 함수를 하나의 요청에 혼합할 수 있어요. 도구 결과는 이제 이미지와 텍스트를 함께 반환할 수 있어요.
- Deep Research 업그레이드: 두 가지 새로운 에이전트 버전(속도 vs. 깊이), 협업 계획, 기본 차트 및 인포그래픽, 이미지/PDF/오디오를 사용한 멀티모달 근거.
- Media generation: Nano Banana 2 를 사용한 이미지 생성 및 Google 이미지 검색 근거, Lyria 3 를 사용한 음악 생성, 다중 화자 TTS 를 사용한 표현력 있는 음성.
- From Roles to Steps: 모든 동작(user_input, thought, function_call, model_output 등)이 고유한 타입의 단계가 되는 단순화된 스키마로, 기존 역할 구조를 대체해요.
- 비용 및 개발자 최적화: Flex 및 Priority 티어를 통해 비용 또는 지연 시간 최적화 가능 (Flex 는 50 % 비용 절감). 오류는 이제 정확한 필드를 가리킵니다. 과거 상호작용은 검색 가능하며 유료 티어에서 55 일 동안 보관.
개발의 새로운 표준
Interactions API 는 이제 Google AI Studio, Gemini API 및 모든 문서에서 기본값이 되었으며, 레거시 형식으로 스니펫을 전환할 수 있는 토글이 포함되어 있어요. 모든 새 프로젝트와 애플리케이션에 Interactions API 를 사용하는 것을 권장합니다.
레거시 generateContent API 는 완전히 지원되며 당분간 계속해서 새로운 주력 Gemini 모델을 받을 예정이지만, 장기 실행 모델 및 에이전트를 위한 최첨단 기능은 점점 더 Interactions API 에만 독점적으로 제공될 것으로 예상합니다. 이는 처음부터 상태 저장 에이전트 워크플로를 위해 설계되었기 때문입니다. 마이그레이션 가이드를 게시했으니 자신의 속도에 맞춰 전환할 수 있어요.
에이전트 우선 생태계
대부분의 개발자는 이제 코딩 에이전트(예: Antigravity)를 사용하여 애플리케이션을 구축하고 있어요. 에이전트가 최신 API 패턴을 쉽게 따라갈 수 있도록 gemini-interactions-api Skill을 구축했습니다. 이 스킬은 Interactions API 개발을 위한 모범 사례 패턴(스트리밍, 함수 호출, 구조화된 출력, Deep Research 등)을 에이전트의 컨텍스트에 주입합니다.
1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
시작하기
Interactions API 는 Python 및 JavaScript SDK 를 통해 사용할 수 있어요. 이미 지원 파트너(LiteLLM, Eigent, Agno) 중 하나를 사용하여 구축 중이라면 오늘부터 Interactions API 통합을 사용할 수 있어요.
Google AI Studio에서 API 키를 가져와 Interactions API 문서를 따라 시작하세요. generateContent 에서 마이그레이션하는 경우 마이그레이션 가이드가 모든 필드를 새 스키마에 매핑해 줍니다. 전체 OpenAPI 사양도 볼 수 있어요.
Interactions API 는 개발자 피드백을 바탕으로 구축되었으며, 일반 공급 이후에도 그 초점은 변하지 않을 거예요. 개발자 포럼에서 필요 사항을 알려주세요.
