ChatGPT API 키 발급부터 첫 호출까지 파이썬으로 10분 만에 완성

작성자:

매일 아침 30분을 날리다가, 파이썬 한 줄로 탈출한 이야기

솔직히 말하면, 나는 ‘개발자’가 아니다. 비전공자다. 그런데 지금은 매일 아침 여러가지 영문 기사 요약을 단 10초 만에 처리한다. ChatGPT API 덕분에. 저사람도 하는데 나도 못할까 하고 시작했다

처음엔 챗GPT 웹 화면을 띄워놓고 기사를 하나씩 복사해서 붙여넣었다. 하루에 30분이 그냥 사라졌다. 게다가 트래픽이 몰리는 출근 시간대엔 답변이 중간에 툭 끊기거나 아예 페이지가 굳어버리는 일이 잦았다. 그 답답함이 쌓이다 보니 어느 날 퇴근 후 자리에 앉아서 OpenAI 공식 문서를 처음 열어봤다. 솔직히 ‘API 연동’이라는 단어가 주는 그 묘한 압박감이 있었다. 하지만 막상 파고들어보니, 파이썬 기초만 있으면 10분 안에 끝나는 일이었다.

이 글은 내가 직접 실패하고 고쳐가며 완성한 가장 빠른 ChatGPT API 파이썬 연동 가이드다.

1. 개발 환경 및 사전 준비물

복잡한 설정은 없다. 아래 환경이면 충분하다. macOS와 Windows 모두 명령어는 동일하니 걱정할 필요 없다.

  • 운영체제: Windows 11 Pro (macOS도 100% 동일 적용)
  • Python 버전: 3.11.4 (최소 3.7.1 이상 권장)
  • 코드 편집기: VS Code (Visual Studio Code)
  • 필수 준비물: 해외 결제 가능한 신용카드 또는 체크카드 (OpenAI API 크레딧 충전용)

파이썬이 설치되어 있지 않다면 python.org에서 최신 버전을 내려받아 설치하자. 설치 시 “Add Python to PATH” 체크박스를 반드시 활성화해야 나중에 터미널에서 명령어가 정상 인식된다. 이 체크를 놓쳐서 한 시간을 날린 적이 있다. 꼭 확인하자.

2. OpenAI 계정 설정 및 ChatGPT API 키 발급받기

파이썬 코드와 ChatGPT를 연결하는 ‘비밀 열쇠’가 바로 API 키다. 이 키 없이는 어떤 코드도 작동하지 않는다. 발급 과정은 3단계, 3분이면 끝난다.

1단계: OpenAI API 플랫폼 접속

일반 ChatGPT 사이트가 아니라 platform.openai.com으로 접속해야 한다. 기존 ChatGPT 계정으로 그대로 로그인하면 된다. 화면 구성이 달라 처음엔 낯설 수 있지만, 좌측 사이드바만 보면 금방 익숙해진다.

2단계: 결제 수단 등록 (절대 건너뛰지 말 것)

예전엔 가입하면 무료 크레딧을 줬지만, 현재 정책상 사전 충전(Pre-pay) 없이는 API 호출 자체가 막혀있다. 좌측 메뉴의 [Settings] → [Billing] 탭으로 이동해 카드를 등록하고 최소 5달러를 충전한다. 나는 이 단계를 건너뛰었다가 코드를 완벽하게 짜놓고도 처음 실행에서 빨간 에러만 마주했다. 뒤에서 자세히 다루겠지만, 충전을 먼저 해두면 그 고통을 겪지 않아도 된다.

3단계: API 키 생성 및 즉시 보관

좌측 메뉴 [API keys] 탭 → ‘Create new secret key’ 버튼 클릭 → 키 이름을 Python_Test처럼 알아보기 쉽게 입력하고 생성한다. 창이 닫히는 순간 그 키는 영영 다시 볼 수 없다. 지금 바로 복사해서 메모장에 임시 저장하자. sk-로 시작하는 긴 문자열이 바로 당신의 API 키다.

3. 단계별 실습: 파이썬으로 첫 번째 API 호출하기

이제 진짜 코드를 짤 차례다. OpenAI 공식 라이브러리를 쓰면 복잡한 HTTP 요청 없이 단 몇 줄로 끝난다.

1단계: 필수 라이브러리 설치

터미널(Windows는 명령 프롬프트, Mac은 Terminal)을 열고 아래 명령어를 입력한다. openai는 ChatGPT와 통신하는 공식 패키지고, python-dotenv는 API 키를 코드 밖에서 안전하게 관리하게 해주는 도구다.

pip install openai python-dotenv

2단계: 환경 변수 파일 생성 (.env)

프로젝트 폴더에 .env라는 이름의 파일을 새로 만들고 아래처럼 입력 후 저장한다. 따옴표는 넣지 않는다.

OPENAI_API_KEY=sk-여기에_발급받은_키를_입력하세요

3단계: API 호출 코드 작성 (main.py)

같은 폴더에 main.py 파일을 만들고 아래 코드를 그대로 붙여넣자. 속도가 빠르고 비용 대비 성능이 탁월한 gpt-4o-mini 모델을 기준으로 작성했다.

import os
from dotenv import load_dotenv
from openai import OpenAI

# .env 파일에서 API 키를 불러옵니다
load_dotenv()

# OpenAI 클라이언트 초기화
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

def get_chatgpt_response(prompt):
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "너는 친절하고 전문적인 IT 번역가이자 요약 전문가야."},
            {"role": "user", "content": prompt}
        ],
        temperature=0.7
    )
    return response.choices[0].message.content

if __name__ == "__main__":
    my_prompt = "인공지능이 현대 비즈니스에 미치는 영향을 3문장으로 요약해줘."
    print("답변을 기다리는 중...\n")
    result = get_chatgpt_response(my_prompt)
    print("==== ChatGPT의 답변 ====")
    print(result)

터미널에서 python main.py를 실행하면 몇 초 안에 ChatGPT가 생성한 3문장 요약이 화면에 출력된다. 처음 그 결과를 봤을 때의 감각은 꽤 짜릿하다.

참고: 목적별 최적 모델 선택 가이드

모델명 특징 및 직접 써본 평가 추천 용도
gpt-4o 현존 최고 성능. 복잡한 추론과 문맥 파악이 탁월하지만 비용이 상대적으로 높다. 복잡한 코드 생성, 심층 데이터 분석, 법률·계약서 검토
gpt-4o-mini (강력 추천) 체감 속도가 gpt-4o 대비 2배 이상 빠르고 비용은 10분의 1 수준. 일상 자동화엔 이걸로 충분하다. 대량 텍스트 요약, 번역, 반복 업무 자동화

4. 내가 직접 터진 치명적 오류 2가지와 완벽 해결법

처음 실행에서 한 번에 성공했다면 그건 정말 운이 좋은 것이다. 나는 두 번 제대로 막혔다. 튜토리얼에선 잘 안 알려주는 함정들이다.

첫 번째 함정: Error 429 – Insufficient Quota

코드를 완벽하게 작성하고 설레는 마음으로 실행했는데, 터미널에 RateLimitError: Error code: 429라는 빨간 글씨가 박혔다. API 키를 수십 번 확인하고 공백도 지워봤지만 소용없었다. 원인은 단순했다. 잔액이 0원이었다. 현재 OpenAI 정책상 계정 생성 후 무료 크레딧은 제공되지 않는다. 최소 5달러를 Billing 페이지에서 먼저 충전해야만 API 호출 권한이 열린다. 충전 후 약 5분 뒤 재실행하니 깔끔하게 작동했다.

두 번째 함정: GitHub에 API 키 통째로 올린 날

빨리 테스트하고 싶어서 코드 안에 api_key="sk-..."를 직접 하드코딩했다. 그리고 아무 생각 없이 GitHub 저장소에 푸시했다. 1분도 안 돼서 OpenAI에서 이메일이 왔다. “당신의 키가 외부 저장소에 노출되어 보안상 즉시 비활성화 처리했습니다.” 그 짧은 시간 안에 크롤러 봇이 키를 긁어갔고, 요금 폭탄으로 이어질 수도 있었던 아찔한 상황이었다. 절대로 코드 안에 API 키를 직접 입력하지 마라. 반드시 .env 파일에 저장하고, .gitignore에 .env를 추가해서 Git 추적에서 제외해야 한다.

5. 자동화 도입 후 실제 수치 변화

기본 스크립트를 완성한 뒤, 파이썬 os 모듈로 특정 폴더의 영문 기사 파일들을 한 번에 읽어 자동 요약하도록 코드를 확장했다. 수치로 보면 이렇다.

  • 소요 시간: 매일 아침 30분 → 스크립트 실행 한 번으로 10초 이내 완료
  • 비용: 일주일간 약 150건 기사 요약 처리 후 청구 금액 0.12달러(약 160원)
  • 업무 집중도: 반복 작업에서 완전히 해방되자, 아침 시간을 데이터 인사이트 도출과 기획 업무에 온전히 투자할 수 있게 됐다

솔직히 처음엔 ’10분짜리 세팅’이 이 정도 효과를 낼 줄은 몰랐다. 하루 30분이 1년이면 180시간이다. ChatGPT API는 그 시간을 되돌려준다.

6. 이런 분께 이 방법을 권한다

ChatGPT API 파이썬 연동은 아래 상황에 딱 맞는 해결책이다.

  • 블로그 포스팅 초안, 대량 데이터 정제, CS 답변 자동화 등 반복적인 텍스트 처리 업무에 지친 직장인·마케터
  • 파이썬 기초는 알고 있지만 API 연동이 막막하게 느껴지는 비전공 개발 입문자
  • ChatGPT 웹 버전의 트래픽 제한과 끊김 현상에 지쳐 안정적인 자동화 환경을 원하는 분

반면, 가끔 아이디어를 얻거나 일상적인 대화가 목적이라면 ChatGPT Plus 구독(월 20달러)이 훨씬 편하다. API는 ‘자동화’가 필요한 순간에 비로소 빛을 발한다. 파이썬 기초 하나만 갖추면, 거기서 응용할 수 있는 범위는 사실상 무제한이다.