googleapis/js-genai

TypeScript 및 JavaScript용 Google Gen AI SDK

무엇인가요 – JavaScript/TypeScript 코드가 Gemini 대규모 언어 모델을 호출할 수 있게 해주는 공식 Google 제공 클라이언트 라이브러리 (@google/genai). 공개 Gemini Developer API(API 키를 통해)와 Gemini Enterprise Agent Platform(구글 클라우드 자격 증명을 통해) 둘 다 지원합니다.

주요 기능

• 모델 호출 – generateContent, generateContentStream, generateImages, generateVideos 등
• 상태 유지 채팅 – ai.chats 객체는 다중 턴 상호작용을 위한 대화 기록을 유지합니다.
• 캐시 – ai.caches를 사용해 서버에 큰 프롬프트 접두사를 저장하여 토큰 비용을 줄일 수 있습니다.
• 파일 처리 – ai.files로 대용량 자산(이미지, 오디오, PDF)을 업로드하고 프롬프트에서 참조할 수 있습니다.
• 라이브 세션 – ai.live로 실시간 텍스트/오디오/비디오 상호작용을 가능하게 합니다.
• 함수 호출 / 도구 – 함수를 선언하거나 내장 도구(Google 검색, 코드 실행, Model Context Protocol)를 사용해 Gemini가 자동으로 호출하도록 할 수 있습니다.
• 인터랙션 API – ai.interactions라는 고수준 래퍼로 상태 관리, 도구 오케스트레이션, 심층 연구 에이전트와 같은 장시간 작업을 관리합니다.

일반적인 사용 예시

import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({apiKey: process.env.GEMINI_API_KEY});
const resp = await ai.models.generateContent({
  model: 'gemini-2.5-flash',
  contents: '하늘은 왜 파란가요?'
});
console.log(resp.text);

동일한 클래스는 Node, 브라우저, 또는 enterprise: true와 함께 프로젝트 및 위치를 전달하는 기업 환경에서도 작동합니다.

설치 – npm install @google/genai (Node 20+ 필요, 이후 버전은 Node 22+ 필요).

문서 및 샘플 – 전체 API 참조는 https://googleapis.github.io/js-genai/ 에 있으며, 리포지토리의 sdk-samples 폴더에는 실행 가능한 예제 모음이 있습니다.

왜 중요한가요 – 개발자에게 Google의 최신 Gemini 2.0+ 기능(멀티모달 입력, 스트리밍, 자동 함수 호출, MCP 등)에 단일하고 최신의 방식으로 접근할 수 있는 기회를 제공하며, 원시 HTTP 호출이나 오래된 SDK를 다루지 않아도 됩니다.