ChatGPT API 키 발급부터 Python 호출 — 입문자 30분 완성 가이드

ChatGPT API 한 번 써보고 싶은데 어디서부터 시작해야 할지 막막하셨죠? 저도 처음 시도했을 때 결제카드 등록부터 막혔거든요.

이 글은 비개발자가 30분 안에 첫 API 호출까지 끝낼 수 있는 단계별 가이드예요. 카드 등록, 키 발급, Python 환경 설정, 5줄 코드 실행, 비용 모니터링까지 다 다룹니다. 한 단계씩 따라만 와요.

1단계 — OpenAI API 계정 만들기 (5분)

ChatGPT 웹 계정과 OpenAI API 계정은 별도예요. 이미 ChatGPT Plus를 쓰고 계셔도 platform.openai.com에 다시 가입해야 합니다.

가입 절차

1. platform.openai.com 접속
2. Sign Up 클릭, 구글 계정 연동이 가장 빨라요
3. 전화번호 인증 (한국 +82 가능)
4. 가입 완료 후 좌측 메뉴 Settings → Billing 이동

결제카드 등록

Billing → Add payment method에서 신용카드 등록. 한국 신용카드 거의 다 됩니다(Visa, Master 우선). 처음엔 5달러 정도 충전해두면 충분해요.

여기서 주의할 점은 OpenAI API는 선결제 충전식이에요. ChatGPT Plus처럼 월 정기 결제가 아니에요. 잔액 떨어지면 자동 충전 옵션을 켜거나 수동으로 충전해야 합니다.

처음엔 자동 충전 끄고 5달러만 충전해서 시작하세요. 사고 방지용이에요.

2단계 — API 키 발급과 안전하게 보관 (5분)

좌측 메뉴 API keys → Create new secret key 클릭. 이름은 "test-1" 같이 식별할 수 있게 적어요.

중요한 두 가지

1. 키는 생성 직후 단 한 번만 전체가 보여요. 새로고침하면 다시는 볼 수 없어요.
2. 메모장이나 비밀번호 매니저(1Password, Bitwarden)에 즉시 저장하세요.

키 형식은 sk-proj-xxxxxxxxxxxxxxxxxxxx 형태예요. 60자 정도 길이입니다.

보관 원칙 4가지

• 절대 코드에 하드코딩하지 말기 (api_key = "sk-..." 금지)
• 환경변수나 .env 파일 사용
• .env는 .gitignore에 등록 후 git에 올리지 않기
• GitHub 공개 레포에 노출 시 즉시 폐기 후 재발급

키 노출 사고가 정말 많아요. 봇이 GitHub를 24시간 스캔해서 노출된 키 발견 즉시 사용해요. 한 시간에 100달러도 사라질 수 있습니다.

3단계 — Python 환경 준비 (10분)

옵션은 두 가지예요. 입문자는 1번 추천합니다.

옵션 1: Google Colab (설치 0분)

colab.research.google.com 접속 → 새 노트 만들기. 끝이에요. Python 환경이 이미 깔려 있어요.

옵션 2: 로컬 PC

Python 3.10 이상 설치(python.org), 터미널에서 pip install openai 실행. VS Code 같은 에디터 추천.

라이브러리 설치는 어느 환경이든 한 줄이에요.

pip install openai

Colab에서는 셀에 !pip install openai로 실행하세요. 느낌표가 셸 명령 실행 표시예요.

4단계 — 첫 API 호출 (5분)

진짜 5줄짜리 첫 코드예요. 키만 본인 거로 바꾸면 됩니다.

from openai import OpenAI

client = OpenAI(api_key="sk-proj-여기에-본인-키")

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "안녕? 한국어로 자기소개 한 문장만 해줘"}]
)

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

실행하면 GPT의 응답이 출력돼요. 여기까지 도달했으면 첫 API 호출 성공입니다.

환경변수로 키 분리하기 (실무 표준)

위 코드는 키가 노출돼서 위험해요. 환경변수로 빼세요.

import os
from openai import OpenAI

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

Colab에서는 좌측 키 아이콘 → Secrets에서 OPENAI_API_KEY 등록 후 Notebook access 토글 켜기.

로컬에서는 .env 파일 만들고 OPENAI_API_KEY=sk-... 적은 후 pip install python-dotenv 설치하고 코드 상단에 from dotenv import load_dotenv; load_dotenv() 추가하세요.

5단계 — 비용 모니터링 설정 (5분)

API 비용 사고 막는 마지막 단계예요. 절대 빼먹지 마세요.

platform.openai.com → Settings → Billing → Usage limits 이동.

• Hard limit: 100달러 (이 금액 넘으면 자동 차단)
• Soft limit: 50달러 (이 금액 넘으면 메일 알림)

처음 한 달은 Hard 20달러 정도로 잡아두면 안전해요. 사용량 익숙해지면 늘리세요.

모델별 비용 차이

2026년 4월 기준 1,000토큰당 가격이에요(입력 / 출력 순).

• GPT-4o: 0.0025달러 / 0.01달러
• GPT-4o-mini: 0.00015달러 / 0.0006달러
• GPT-4.5 Preview: 0.075달러 / 0.15달러
• o1: 0.015달러 / 0.06달러

입문자는 무조건 4o-mini로 시작하세요. 4o의 1/16 가격이고 한국어 품질도 충분합니다.

자주 막히는 4가지 — 실제 입문자 질문

오류: AuthenticationError

키가 잘못됐거나 결제카드가 등록 안 된 상태예요. platform.openai.com에서 키 다시 복사하고, Billing에서 충전 잔액 1달러 이상 있는지 확인하세요.

오류: RateLimitError

분당 호출 한도 초과예요. Tier 1(첫 결제 후) 기준 분당 500회까지 가능한데, 그 이상 빠르게 호출하면 발생. time.sleep(1) 넣어서 1초 간격으로 호출하세요.

한국어 응답이 깨져 나와요

거의 인코딩 문제예요. 터미널에서 출력 시 print(response.choices[0].message.content.encode('utf-8').decode('utf-8'))로 명시하거나 Colab/주피터에선 자동 처리됩니다.

비용이 예상보다 많이 나와요

응답 토큰이 길어서 그래요. max_tokens=200 같은 파라미터로 응답 길이를 제한하세요. 시스템 프롬프트도 짧게 유지하면 입력 비용 줄어요.

비슷한 가이드로 Gemini API Python 연동이나 ChatGPT API 비즈니스 자동화도 참고하세요. 다른 모델과 비교해서 쓰면 단가 절감에 도움이 됩니다.

30분 안에 끝낸 사람들이 한 일

• 결제카드 등록 + 5달러 충전 (5분)
• API 키 발급 + .env 저장 (5분)
• Colab에서 첫 호출 성공 (10분)
• 환경변수로 키 분리 (5분)
• Usage limit 100달러 설정 (5분)

여기까지 마쳤다면 이제 ChatGPT API 위에서 뭐든 만들 수 있어요. 챗봇, 자동 요약, 번역, 이메일 작성기까지 다요.