Google Gen AI Java SDK

정의 – Java 코드에서 Google의 Gemini 대규모 언어 모델 API(공개 Gemini Developer API 및 Gemini Enterprise Agent Platform)를 호출할 수 있는 공식 Java 클라이언트 라이브러리입니다.

주요 기능

• API 키, GCP 프로젝트/위치 또는 "엔터프라이즈" 모드를 구성하는 간단한 Client 빌더.
• 주요 Gemini 엔드포인트 지원: generateContent(텍스트, 다중 모드, 스트리밍, 비동기), 토큰 계산, 비디오 생성.
• 세밀한 HTTP 제어를 위한 구성 객체(HttpOptions, HttpRetryOptions, ClientOptions). 사용자 지정 OkHttp 클라이언트, 프록시, 시간 초과 및 재시도 정책 포함.
• GenerateContentConfig를 통한 고급 모델 옵션: 시스템 지침, 안전 설정, 도구 사용(Google Search, 자동 함수 호출), 응답 스키마, 토큰 제한 및 사고 예산.
• 자동 함수 호출(AFC) – Java 정적 메서드를 모델이 호출할 수 있는 도구로 노출.
• 저지연 또는 비차단 사용을 위한 스트리밍 및 비동기 API.
• Maven 아티팩트 com.google.genai:google-genai(현재 1.77.0, v2.0.0부터 Java 17+ 필요).

일반적인 사용 흐름

1. Maven 종속성을 추가합니다.
2. GOOGLE_API_KEY(또는 엔터프라이즈 모드의 프로젝트/위치 환경 변수)를 설정하거나 Client.builder()에 전달합니다.
3. Client 인스턴스를 생성합니다.
4. client.models.generateContent(modelName, prompt, config)(또는 스트리밍/비동기 변형)를 호출합니다.
5. 선택적으로 구성 객체를 사용하여 HTTP 동작을 사용자 지정하거나 도구/안전 설정을 활성화합니다.

대상 사용자 – 원시 HTTP 호출을 처리하지 않고 Gemini LLM 기능(텍스트 생성, 다중 모드 이미지 설명, 함수 호출 또는 구조화된 JSON 출력)을 백엔드 서비스, 데스크톱 앱 또는 Android 스타일 JVM 프로젝트에 통합하려는 Java 개발자.

제한 사항 / 향후 변경 사항

• 다음 주요 버전에서 AFC는 Models.generate_content에서 Chats 모듈로 이동합니다.
• SDK 2.0.0부터 Java 17이 최소 지원 버전이 됩니다. 이전 JDK가 필요한 경우 버전을 고정하세요.

자세히 알아보기 – 저장소의 README에는 Maven 배지, Javadoc 및 각 기능에 대한 examples/ 디렉토리의 예제 코드 링크가 있습니다.