Skip to main content

OpenAI API를 사용하는 GPT-4.1 Python 빠른 시작

OpenAI API를 사용해 Python에서 로컬 머신으로 GPT-4.1을 설정하고 실행하는 방법. 이 글은 AI 번역본입니다. 오역 가능성이 있으면 댓글로 자유롭게 알려주세요.
Created on September 15|Last edited on September 15
다른 사람들과 마찬가지로, 소식을 듣자마자 바로 GPT-4.1을 만져 보고 싶어 무척 들떴습니다. 4월 14일 OpenAI 발표당신도 그럴 것 같아 이 퀵스타트를 준비했습니다. 같은 발표에서 곧 사용 중단될 예정이라고 들은 GPT-4.5를 대체하는 안내서입니다.
💡
OpenAI API로 GPT-4.1을 실행하면 ChatGPT나 기타 인터페이스에서 경험한 것 이상으로 다양한 가능성이 열립니다. 이 퀵스타트 가이드에서는 몇 가지 단계만 따라 설정을 마치고 약 5분 안에 바로 실험을 시작할 수 있도록 안내합니다.
이미 OpenAI API 키가 있다면, 이제 …
Jump to the tutorial


바로 실행해 보는 것을 선호하는 분들을 위해 편리한 Colab도 준비했습니다.

이번에 다룰 내용은 다음과 같습니다:

목차


이제 막 시작했고 아직 Python을 실행할 수 있도록 내 컴퓨터를 설정하지 않았다면간단한 튜토리얼을 만들었습니다 여기 몇 분 안에 바로 시작할 수 있도록 도와드립니다.
💡
설정이 끝났다면 OpenAI API가 필요합니다. 그러니 여기서부터 시작해 보겠습니다:

OpenAI API 준비하기

GPT-4.1을 사용하기 전에 액세스할 수 있도록 API 키가 필요합니다.
하나를 받으려면, 바로 이동하세요 OpenAI 제품 페이지, 그리고 "Start building"을 클릭하세요.

가입 방법을 선택하세요(저는 Google을 선택했습니다). 그런 다음 인증 절차를 진행하세요. 이 단계에서는 문자 메시지를 받을 수 있는 휴대전화가 필요합니다.
모든 절차가 완료되면, 다음으로 이동하세요 API 프로젝트 키 만들기 (사용자 키를 대체했습니다). 이는 OpenAI가 스크립트를 사용자의 계정과 연결할 수 있도록 하기 위함입니다. 누가 무엇을 하고 있는지 파악하고, 사용 내역에 따라 과금 여부와 금액을 결정하는 것이 중요합니다.

OpenAI API 키 만들기

아직 API 키용 프로젝트를 만들지 않았다면 지금 만들어 주세요. 이 가이드에서는 예시로 이러한 애플리케이션을 위해 “Scripts”라는 단일 프로젝트 하나만 사용합니다.
프로젝트를 만들려면 왼쪽 상단의 "Default project"를 클릭한 다음 "Create project"를 선택하세요.


키를 만들려면 Dashboard로 이동한 다음 "API keys"를 클릭하세요.

…그다음 키를 생성하세요.

이렇게 하면 라이트박스가 열립니다:


어떤 권한을 부여할지 결정하세요. 이에 대한 자세한 내용은 여기에서 확인할 수 있습니다. 여기.
아주 안전한 장소가 아니라면 키를 저장하지 마세요(데스크톱의 메모장 문서는 안전한 장소가 아닙니다). 잠깐 사용했으면 저장하지 말고 메모장 문서를 닫으세요.
💡

OpenAI 가격 정책

가입하면 5달러의 크레���이 제공되며, 가볍게 실험하는 데는 예상보다 충분합니다!
이 문서 작성 시점(2025년 4월 14일) 기준 GPT-4.1의 가��은 다음과 같습니다:
소스

W&B Weave

W&B Weave 모델 출력의 추적과 평가를 간편하게 할 수 있는 방식으로 프로젝트를 강화합니다. Weave를 사용하려면, 먼저 Weave를 임포트한 뒤 프로젝트 이름으로 초기화하세요.
핵심 기능은 @weave.op() 데코레이터로, 추적하려는 함수 위에 추가합니다. Python에서 데코레이터는 다른 함수에 기능을 덧붙이는 특별한 함수입니다. 이를 추가하면 @weave.op() 함수 정의 위에 추가하면, Weave가 해당 함수의 입력과 출력을 자동으로 기록하도록 지시하게 됩니다. 이렇게 하면 함수에 어떤 데이터가 들어가고 어떤 결과가 나오는지 쉽게 모니터링할 수 있습니다.
코드를 실행한 후에는 Weave 대시보드에서 이러한 로그를 확인할 수 있으며, 함수 호출에 대한 상세한 시각화와 트레이스를 제공합니다. 이는 디버깅과 실험 데이터 정리에 도움이 되어, GPT-4와의 개발 과정을 더 효율적이고 통찰력 있게 만듭니다.

GPT-4.1 시작하기

이 튜토리얼의 스크린샷에서는 제가 Jupyter Notebooks를 사용하는 모습을 보여줍니다.
Colab이나 Jupyter를 처음 사용한다면 훌륭한 빠른 시작 가이드가 있습니다 여기. 그리고 핵심 마크다운에 대한 간단한 복습 여기.
Jupyter Notebooks의 뛰어난 장점 중 하나는 Colab과 마찬가지로 마크다운 필드에 주석과 맥락을 자유롭게 추가할 수 있다는 점입니다:

내용과 맥락은 여기에서 제가 쓰는 설명을 그대로 코드의 동작 설명으로 사용할 것입니다. 함께 따라 하고 있다면, 이 부분은 제외하거나 본인 버전으로 바꿔 넣으세요.

1단계: OpenAI GPT-4.1 API 키

가장 먼저 해야 할 일은 GPT-4.1 API 키를 정의하는 것입니다.
이를 위한 코드는 다음과 같습니다:
%env OPENAI_API_KEY=KEY
"KEY"를 OpenAI API로 바꿔 넣어야 합니다.
셀을 실행하면 출력으로 키가 그대로 표시됩니다. 이는 환경 변수로 정상적으로 설정되었음을 확인해 줍니다.


2단계: OpenAI와 W&B Weave 설치

GPT-4.1을 사용하려면 OpenAI만 있으면 됩니다. 하지만 아래에서는 W&B Weave를 사용해 입력과 출력을 손쉽게 추적하는 방법을 보여 드리겠습니다.
지금이 좋은 때입니다 Weights & Biases에 가입하기몇 분 뒤 흐름이 한창일 때 작업을 끊지 않도록, 미리 저장해 두세요.
이 빠른 시작 가이드의 맥락에서는 그리 중요하지 않을 수 있지만, GPT-4.1과 다른 모델을 더 고급 기능에 활용하기 시작하면 처음부터 올바르게 준비해 둔 것이 분명 큰 도움이 될 것입니다.
재미있는 사실: OpenAI는 Weights & Biases의 첫 유료 고객이었습니다!
💡
이를 위한 코드는 다음과 같습니다:
!pip install openai weave
그리고 해당 셀을 실행하세요.
주피터 셀을 실행하면 대괄호 [ ] 사이가 별표([*])로 채워지는 것을 볼 수 있습니다. 이는 해당 셀이 실행 중임을 의미하며, 계속하기 전에 별표(*)가 숫자로 바뀔 때까지 기다리세요..
💡

이제 설치는 끝났으니, 사용하려면 가져오기(import)가 아직 필요합니다.
Python이 처음이라면기본적으로 라이브러리를 설치할 때는 그 코드를 가져오는 것이고, 임포트할 때는 해당 라이브러리를 사용할 수 있게 만드는 것입니다.

예전에 들은 비유가 참 좋았어요. 설치는 이미지를 서버에 업로드하는 것과 같고, 임포트는 그 이미지가 준비되면 페이지에 삽입해 사용하는 것과 같아요.
💡

3단계: 라이브러리를 임포트하고 OpenAI API 키를 전달하기

이제 본격적으로 작업을 시작하기 위해 필요한 라이브러리를 임포트하고, OpenAI에 API 키를 전달해 GPT-4.1에 접근할 수 있도록 준비하겠습니다.
이 블록에서는 이미 설치한 OpenAI와 W&B 라이브러리를 임포트합니다.
import os
import weave
from openai import OpenAI

# Initialize Weave
weave.init('gpt-4-setup')

# Initialize OpenAI client
client = OpenAI(api_key=os.getenv('OPENAI_API_KEY'))

4단계: GPT-4.1 프롬프트 설정하기

평소에 ChatGPT를 쓰면서 어시스턴트를 구체적으로 정의하지 않았다면, 이 방법을 꼭 써 보세요. 예를 들어 “당신은 화이트햇 전술만 사용하는 SEO 전문가입니다 …”처럼 프롬프트를 시작하면, 모델이 결과를 더 적절한 방향으로 구성하는 데 도움이 됩니다.
GPT-4.1용 OpenAI API를 사용할 때 반드시 거쳐야 하는 단계입니다.
💡
아래 코드는 여러분이 채워 넣을 입력 항목을 생성합니다. 다음 정보를 요청합니다:
  • 어시스턴트의 역할을 정의하세요. 이는 모델이 어떻게 동작해야 하는지를 지정하여 정체성을 설정하는 과정입니다. 예를 들어 “당신의 프롬프트에 답하는 동안 나는 누구여야 하나요?”라는 입력에 대해 “LLM을 학습 중인 머신러닝 엔지니어”처럼 지정하면, 모델이 그에 맞춰 응답하도록 유도할 수 있습니다.
  • 사용자의 작업을 설정하세요. 이는 모델에게 수행할 작업을 정의합니다. 예를 들어 “무엇을 해 주길 원하나요?”라는 질문에 대한 입력으로 “내 코드에서 Weights & Biases를 사용해 팀과 더 효율적으로 협업하는 방법을 설명해 주세요.”처럼 구체적인 요청을 제공하면, 모델이 수행해야 할 행동을 이해하는 데 도움이 됩니다.
gpt_assistant_prompt = "You are a " + input ("Who should I be, as I answer your prompt?")
gpt_user_prompt = input ("What do you want me to do?")


5단계: GPT-4.1로 콘텐츠 생성하기

이제 남은 일은 콘텐츠를 생성하는 것뿐입니다.
먼저 이를 수행할 함수들을 정의하고 실행하겠습니다.
@weave.op()
def generate_content(gpt_assistant_prompt: str, gpt_user_prompt: str) -> dict:
gpt_prompt = f"{gpt_assistant_prompt} {gpt_user_prompt}"
messages = [
{"role": "assistant", "content": gpt_assistant_prompt},
{"role": "user", "content": gpt_user_prompt}
]
response = client.chat.completions.create(
model="gpt-4.1", # Ensure correct model name is used
messages=messages,
temperature=0.2,
max_tokens=1000,
frequency_penalty=0.0
)
response_text = response.choices[0].message.content
tokens_used = response.usage.total_tokens
return {"response": response_text, "tokens_used": tokens_used}

# Call the function
result = generate_content(gpt_assistant_prompt, gpt_user_prompt)
print(result)
어시스턴트와 사용자 역할을 모두 메시지로 보내고 있다는 점에 주목하세요.
추가로, 응답 기준에 다음 내용을 정의합니다:
  • temperature모델 출력의 무작위성(창의성)을 조절하는 0 이상 1.0 이하의 값입니다. 0.2처럼 낮은 값을 사용하면 출력이 더 집중되고 결정론적으로 바뀌어, 창의성은 낮아지지만 정확성은 높아집니다.
  • max_tokens: 응답에서 사용할 최대 토큰 수(단어 및 단어의 일부)를 제한합니다. 모델은 성능과 상세함 사이의 균형을 맞추기 위해 답변에서 최대 1000개의 토큰을 생성합니다.
  • frequency_penalty: -2.0부터 2.0 사이의 값으로, 모델이 토큰을 반복할 가능성을 조절합니다. 0.0은 페널티 없음(자연스러운 반복 허용)을 의미합니다. 더 높은 값을 사용하면 생성된 텍스트에서 반복이 줄어듭니다.
그리고
실행하면 다음과 같이 표시됩니다:

요청에 몇 가지 추가 매개변수를 함께 전달한 것을 보셨을 겁니다. 숫자는 변경할 수 있으며, 전체 매개변수 목록은 OpenAI 사이트에서 확인할 수 있습니다. 여기.
제가 사용하는 항목은 다음과 같습니다:
  • 모델 - 사용하려는 모델.
  • 메시지 - 전송되는 메시지(대부분 프롬프트).
  • 온도 - 0과 1 사이의 숫자이며, 값이 높을수록 무작위성이 커집니다. 값이 높으면 더 창의적일 수 있지만, 결과의 예측 가능성은 낮아집니다.
  • frequency_penalty - -2에서 2 사이의 숫자입니다. 값이 높을수록 지금까지의 응답에서 등장한 빈도에 따라 새로운 토큰에 더 큰 패널티를 부여합니다. 숫자가 높을수록 반복될 확률이 낮아집니다.

W&B Weave에서 GPT-4.1 입력과 출력 보기

제가 추가한 것을 알아차리실 거예요 @weave.op() 위의 generate_content 함수로, 여기에 추가된 함수의 입력과 출력을 기록하는 W&B Weave를 추가합니다. 스크립트를 실행한 뒤에는 프로젝트 페이지로 이동하거나 출력 상단에 표시된 링크를 클릭하면 최신 Trace로 바로 이동할 수 있습니다.

다음과 같은 화면이 보일 것입니다:


오른쪽 상단의 탭을 클릭하면 다음과 같은 추가 정보를 확인할 수 있습니다:
해당 Trace를 생성한 코드:

동료나 기타 사용자로부터 받은 Trace에 대한 피드백
그리고 실행 중이던 환경 요약은 다음과 같습니다:



결론

몇 가지 단계만 거치면 이제 Python에서 OpenAI API를 통해 GPT-4.1을 실행하고, W&B Weave와 연동해 원활한 추적과 시각화를 사용할 수 있습니다. 프롬프트를 미세 조정하든 입력과 출력을 관리하든, 이 설정은 생성형 AI 프로젝트를 완전히 주도할 수 있도록 도와줍니다.
계속해서 실험하고, 파라미터를 조정하며, GPT-4.1로 새로운 가능성을 탐��해 보세요. 더 깊은 인사이트와 최적화를 위해 아래의 관련 자료를 확인하고, AI 기반 콘텐츠 제작의 세계로 마음껏 파고들어 보시기 바랍니다.

관련 자료



이 글은 AI로 번역된 기사입니다. 오역이 의심되는 부분이 있다면 댓글로 알려 주세요. 원문 보고서는 다음 링크에서 확인할 수 있습니다: 원문 보고서 보기
Dave Davies
Dave Davies •  
Sorry for the delayed reply to all. I changed my account. :) I've now updated it, so all errors should be sorted out.
Reply
Bijan Nikouravan
Bijan Nikouravan •  
More over, I was not able to past API key for logging in to the wandb library from Anaconda Prompt. Thank you if guide me.
Reply
Bijan Nikouravan
Bijan Nikouravan •  
Thank you for present nice blog. I was trying to follow all of your comments but finally I hade some problem. I appreciate if you can guide me in this regard. the error is a s follow (this is only part of error): InvalidRequestError: The model `gpt-4` does not exist or you do not have access to it. Learn more: https://help.openai.com/en/articles/7102672-how-can-i-access-gpt-4.
1 reply
Zzavk
Zzavk •  
nice blog :)
Reply