여러 LLM 제공업체에서 Pydantic으로 검증된 구조화 데이터를 가져오고, 검증 실패 시 자동으로 재시도하는 Python 라이브러리입니다.
openai/openai-java
동기·비동기 클라이언트, 스트리밍, 타입 지정 요청 및 응답 클래스를 제공하는 OpenAI REST API 공식 Java·Kotlin SDK입니다.
- 스타
- 1,554
- 포크
- 272
- 열린 이슈
- 66
- 마지막 커밋
- 6시간 전
어떤 프로젝트인가요?
openai-java는 Java 애플리케이션에서 OpenAI API를 호출할 수 있는 공식 Java 라이브러리입니다. REST 엔드포인트를 타입이 지정된 빌더와 응답 클래스로 감싸므로, 개발자는 직접 JSON을 작성하는 대신 Java 객체를 다룰 수 있습니다. 주요 진입점은 Responses API이며, Chat Completions API도 지원합니다.
동기 및 비동기 클라이언트를 모두 제공하며, 스트리밍 메서드는 데이터가 도착하는 대로 처리할 수 있는 청크 스트림을 반환합니다. 헬퍼 클래스를 사용하면 스트리밍된 채팅 완성과 응답을 완전한 객체로 누적할 수 있습니다. 일반 Java 클래스에서 구조화된 출력을 자동으로 생성할 수 있으며, 선택적으로 Jackson 및 Swagger 애너테이션을 사용해 생성되는 JSON 스키마를 지정할 수 있습니다.
SDK는 시스템 속성이나 환경 변수를 통한 설정, Kubernetes·Azure·GCP용 워크로드 아이덴티티 인증도 지원합니다. Amazon Bedrock에서 OpenAI 호환 API를 호출할 수 있는 선택적 아티팩트도 제공합니다.
핵심 기능
- 01Responses API와 Chat Completions API용 타입 지정 Java 빌더 및 응답 클래스.
- 02CompletableFuture를 반환하는 비동기 메서드를 포함한 동기 및 비동기 클라이언트.
- 03SSE 스트리밍과 청크를 완전한 응답으로 누적하는 헬퍼.
- 04Java 클래스에서 생성하고 로컬에서 JSON 스키마를 검증하는 구조화된 출력.
- 05Kubernetes·Azure·GCP용 워크로드 아이덴티티 인증.
활용 사례
- Java 또는 Kotlin 백엔드 서비스에 OpenAI 기반 텍스트 생성을 추가.
- 생성되는 모델 출력을 웹 또는 데스크톱 클라이언트에 스트리밍.
- 모델 응답에서 구조화된 데이터를 추출해 Java 도메인 객체로 변환.
- Java 애플리케이션에서 Amazon Bedrock의 OpenAI 호환 모델 호출.
빠른 시작
- 1
Gradle 의존성을 추가합니다
implementation("com.openai:openai-java:4.90.0") - 2
환경 변수에서 클라이언트를 생성합니다
OpenAIClient client = OpenAIOkHttpClient.fromEnv();
사용 전 알아둘 점
- README 예제에서는 OPENAI_API_KEY 환경 변수를 사용하므로 요청을 보내려면 OpenAI API 키가 필요합니다.
토픽
자주 묻는 질문
- openai-java은(는) 무엇인가요?
- 동기·비동기 클라이언트, 스트리밍, 타입 지정 요청 및 응답 클래스를 제공하는 OpenAI REST API 공식 Java·Kotlin SDK입니다. openai-java는 Java 애플리케이션에서 OpenAI API를 호출할 수 있는 공식 Java 라이브러리입니다. REST 엔드포인트를 타입이 지정된 빌더와 응답 클래스로 감싸므로, 개발자는 직접 JSON을 작성하는 대신 Java 객체를 다룰 수 있습니다. 주요 진입점은 Responses API이며, Chat Completions API도 지원합니다.
- openai-java은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- openai-java은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- openai-java은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. openai-java의 마지막 커밋은 2026년 10월 22일입니다.
- openai-java은(는) 어디에 사용할 수 있나요?
- Java 또는 Kotlin 백엔드 서비스에 OpenAI 기반 텍스트 생성을 추가. 생성되는 모델 출력을 웹 또는 데스크톱 클라이언트에 스트리밍. 모델 응답에서 구조화된 데이터를 추출해 Java 도메인 객체로 변환. Java 애플리케이션에서 Amazon Bedrock의 OpenAI 호환 모델 호출.
- openai-java는 어떻게 설치하나요?
- Gradle 의존성을 추가합니다: implementation("com.openai:openai-java:4.90.0") 환경 변수에서 클라이언트를 생성합니다: OpenAIClient client = OpenAIOkHttpClient.fromEnv();
- openai-java은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/openai-java
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
서버 측 JavaScript 및 TypeScript 애플리케이션에서 Anthropic의 Claude API를 호출하기 위한 공식 TypeScript SDK입니다.
Python, .NET, Java에서 모델·플러그인·벡터 데이터베이스 연동을 통해 AI 에이전트와 멀티 에이전트 시스템을 구축하는 SDK입니다.
동기·비동기 클라이언트와 타입 지정 요청·응답 모델을 제공하는 OpenAI REST API 공식 Python 라이브러리입니다.
IDE 확장, 터미널 CLI, 데스크톱 앱 또는 SDK로 실행되는 오픈소스 자율 코딩 에이전트입니다.
AI 에이전트에 1,000개 이상의 사전 인증 앱 툴킷, 사용자별 세션, 작업 실행용 샌드박스를 제공하는 TypeScript 및 Python SDK입니다.