🐍오픈소스

OpenAI Python 라이브러리 완벽 가이드

OpenAI API를 Python에서 쉽게 사용할 수 있는 공식 라이브러리 소개

원본 링크
#OpenAI#Python#API#GPT

OpenAI Python 라이브러리란?

OpenAI의 공식 Python 라이브러리로, Python 3.9 이상에서 OpenAI REST API를 편리하게 사용할 수 있습니다. 동기/비동기 클라이언트를 모두 지원하며, 모든 요청과 응답에 대한 타입 정의가 포함되어 있습니다.

설치 방법

PyPI를 통해 간단하게 설치할 수 있습니다:

bash
pip install openai

기본 사용법

Responses API (최신 방식)

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),
)

response = client.responses.create(
    model="gpt-5.2",
    instructions="You are a coding assistant that talks like a pirate.",
    input="How do I check if a Python object is an instance of a class?",
)

print(response.output_text)

Chat Completions API (기존 방식)

python
from openai import OpenAI

client = OpenAI()

completion = client.chat.completions.create(
    model="gpt-5.2",
    messages=[
        {"role": "developer", "content": "Talk like a pirate."},
        {"role": "user", "content": "How do I check if a Python object is an instance of a class?"},
    ],
)

print(completion.choices[0].message.content)

API 키 관리

API 키는 소스 코드에 직접 저장하지 말고, .env 파일을 사용하는 것을 권장합니다:

1.python-dotenv 설치
2..env 파일에 OPENAI_API_KEY="My API Key" 추가
3.API 키는 OpenAI 설정 페이지에서 발급

주요 특징

✅ Python 3.9 이상 지원
✅ 동기/비동기 클라이언트 지원
✅ 완전한 타입 정의 제공
✅ httpx 기반의 안정적인 HTTP 통신
✅ OpenAPI 스펙 기반 자동 생성

참고 문서

[공식 API 문서](https://platform.openai.com/docs/api-reference)
[전체 API 레퍼런스](https://github.com/openai/openai-python/blob/main/api.md)