공식 openai 패키지는 Python 3.8 이상에서 동작해. pip install openai 로 설치하되, 프로젝트가 사용하는 관리된 환경 안에서 실행해. system Python 에 전역 설치하면 다른 프로젝트와 충돌하고 나중에 정리하기도 어려워.
실제 버전은 lockfile 에 고정해
SDK 는 자주 업데이트되고 큰 버전이 바뀔 때 parameter 구조도 달라질 수 있어. max_tokens 에서 max_completion_tokens 로 옮겨간 게 한 예야. dependency 를 고정하지 않으면 같은 소스도 설치한 날짜에 따라 다른 버전을 받아 갑자기 깨질 수 있어.
권장하는 버전 관리 방식
requirements.txt 에 openai>=1.78,<2 처럼 허용 범위를 적고, uv.lock, poetry.lock, pip-compile 출력 같은 lockfile 에 실제 설치 버전을 고정해. 업데이트는 정해둔 일정에 따라 검증하면서 올려.
설치 확인
API key 환경 변수를 설정한 뒤 python -c "from openai import OpenAI; print(OpenAI().models.list().data[0].id)" 를 실행해. 첫 번째 모델 ID 가 나오면 client 와 인증이 제대로 연결된 거야.