Repolode
openai

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. 1

    Gradle 의존성을 추가합니다

    implementation("com.openai:openai-java:4.90.0")
  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트