Ollama의 로컬 및 클라우드 모델을 chat, generate, embed, 모델 관리 API로 호출할 수 있는 공식 Python 클라이언트 라이브러리입니다.
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
PyPI에서 라이브러리를 설치합니다
pip install openai - 2
OPENAI_API_KEY 환경 변수에 API 키를 설정합니다
- 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 통계는 매일 갱신됩니다.
관련 프로젝트
모델, 임베딩, 벡터 저장소와 서드파티 통합을 위한 표준 인터페이스를 제공하는 LLM 기반 애플리케이션 및 에이전트 구축용 Python 프레임워크입니다.
도구, 핸드오프, 가드레일, 세션, 트레이싱을 활용해 멀티 에이전트 워크플로를 구축하는 경량 Python 프레임워크로, OpenAI와 100개 이상의 LLM을 제공자에 구애받지 않고 지원합니다.
LLM 애플리케이션을 도구, 데이터, 프롬프트에 연결하는 Model Context Protocol 서버와 클라이언트를 구축하기 위한 공식 Python SDK입니다.
OpenAI 모델용 고속 BPE 토크나이저로, 텍스트를 토큰으로 변환하고 손실 없이 다시 복원합니다.
원격 및 로컬 대규모 언어 모델에 프롬프트를 보내고 대화할 수 있는 CLI 도구이자 Python 라이브러리입니다.