Repolode
openai

openai/openai-python

동기·비동기 클라이언트와 타입 지정 요청·응답 모델을 제공하는 OpenAI REST API 공식 Python 라이브러리입니다.

스타
31,893
포크
8,476
열린 이슈
147
마지막 커밋
7시간 전

어떤 프로젝트인가요?

openai-python은 OpenAI REST API의 공식 Python 클라이언트이며 Python 3.10 이상을 지원합니다. HTTPX2를 기반으로 한 동기 및 비동기 클라이언트를 모두 제공하며, 모든 요청 매개변수와 응답 필드에 대한 타입 정의를 포함합니다. 이 라이브러리는 OpenAI의 OpenAPI 사양을 바탕으로 생성됩니다.

주요 인터페이스는 Responses API이며, Chat Completions API도 계속 지원합니다. 이 라이브러리는 Server-Sent Events를 통한 스트리밍, 텍스트와 오디오를 위한 WebSockets 기반 Realtime API 클라이언트, 자동 페이지네이션을 지원하는 목록 메서드, 파일 업로드, 웹훅 서명 검증, 설정 가능한 타임아웃을 적용한 자동 재시도도 제공합니다. 응답은 Pydantic 모델이며 to_json() 및 to_dict() 같은 헬퍼를 사용할 수 있습니다.

이 SDK는 전용 AzureOpenAI 클래스를 통해 Azure OpenAI와도 연동되며, AWS 인증을 처리하는 공급자 설정을 통해 Amazon Bedrock의 OpenAI 호환 API도 지원합니다. Kubernetes, Azure, GCP의 워크로드 아이덴티티 인증과 X.509 상호 TLS 설정 방법도 문서화되어 있습니다.

핵심 기능

  • 01인터페이스가 동일한 동기 및 비동기 클라이언트
  • 02타입이 지정된 요청 매개변수(TypedDict)와 Pydantic 응답 모델
  • 03Server-Sent Events를 통한 스트리밍 응답
  • 04텍스트와 오디오를 위한 WebSockets 기반 Realtime API
  • 05자동 페이지네이션을 지원하는 목록 메서드와 파일 업로드 헬퍼
  • 06웹훅 서명 검증 및 페이로드 파싱
  • 07자동 재시도와 설정 가능한 타임아웃

활용 사례

  • Responses 또는 Chat Completions API로 OpenAI 모델을 호출하는 Python 백엔드 구축
  • 비동기 웹 서비스에 스트리밍 텍스트 생성을 추가
  • Realtime API로 지연 시간이 짧은 음성 또는 텍스트 대화형 앱 구축
  • 동일한 클라이언트 코드로 Azure OpenAI 또는 Amazon Bedrock에서 OpenAI 모델 호출

빠른 시작

  1. 1

    PyPI에서 라이브러리를 설치합니다

    pip install openai
  2. 2

    OPENAI_API_KEY 환경 변수에 API 키를 설정합니다

  3. 3

    README에 나온 대로 클라이언트를 만들고 Responses API를 호출합니다

사용 전 알아둘 점

  • 요청을 보내려면 OpenAI API 키와 OpenAI 유료 API 사용이 필요합니다.
  • Python 3.10 이상이 필요합니다.

토픽

자주 묻는 질문

openai-python은(는) 무엇인가요?
동기·비동기 클라이언트와 타입 지정 요청·응답 모델을 제공하는 OpenAI REST API 공식 Python 라이브러리입니다. openai-python은 OpenAI REST API의 공식 Python 클라이언트이며 Python 3.10 이상을 지원합니다. HTTPX2를 기반으로 한 동기 및 비동기 클라이언트를 모두 제공하며, 모든 요청 매개변수와 응답 필드에 대한 타입 정의를 포함합니다. 이 라이브러리는 OpenAI의 OpenAPI 사양을 바탕으로 생성됩니다.
openai-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openai-python은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openai-python은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openai-python의 마지막 커밋은 2026년 10월 20일입니다.
openai-python은(는) 어디에 사용할 수 있나요?
Responses 또는 Chat Completions API로 OpenAI 모델을 호출하는 Python 백엔드 구축 비동기 웹 서비스에 스트리밍 텍스트 생성을 추가 Realtime API로 지연 시간이 짧은 음성 또는 텍스트 대화형 앱 구축 동일한 클라이언트 코드로 Azure OpenAI 또는 Amazon Bedrock에서 OpenAI 모델 호출
openai-python는 어떻게 설치하나요?
PyPI에서 라이브러리를 설치합니다: pip install openai OPENAI_API_KEY 환경 변수에 API 키를 설정합니다 README에 나온 대로 클라이언트를 만들고 Responses API를 호출합니다
openai-python은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/openai-python

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트