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 비즈니스 자동화도 참고하세요. 다른 모델과 비교해서 쓰면 단가 절감에 도움이 됩니다.

API가 맞는 경우 vs ChatGPT 화면이 맞는 경우

가장 많이 받는 질문이 "굳이 API를 써야 하나요"예요. 판단 기준은 단순합니다. 같은 작업을 반복하느냐, 결과를 다른 프로그램에 넘기느냐 두 가지예요.

API가 맞는 경우

• 같은 형식의 작업을 수십, 수백 건 돌려야 할 때 (상품 설명 일괄 생성, 리뷰 일괄 분류)
• 결과를 엑셀·데이터베이스·슬랙 같은 다른 도구에 자동으로 넣어야 할 때
• 내 서비스 안에 챗봇이나 요약 기능을 넣어야 할 때
• 프롬프트를 고정해두고 입력값만 바꿔가며 돌려야 할 때

ChatGPT 화면이 맞는 경우

• 하루에 몇 번, 그때그때 다른 질문을 던질 때
• 대화를 주고받으며 생각을 정리하는 작업
• 파일 업로드·이미지·웹 검색 같은 부가 기능이 필요할 때
• 코딩을 전혀 하고 싶지 않을 때

정리하면 반복과 연결이 필요하면 API, 탐색과 대화가 목적이면 화면입니다. 둘 중 하나를 고르는 게 아니라 용도에 따라 나눠 쓰는 게 정답이에요.

첫 호출 성공 직후 바로 해둘 3가지

첫 응답이 출력됐다고 끝이 아니에요. 여기서 멈추면 나중에 반드시 한 번 고생합니다.

1. 키를 코드 밖으로 빼기

위에서 다룬 환경변수 분리를 그날 바로 하세요. "나중에 정리해야지" 하고 미룬 하드코딩 키가 그대로 커밋되는 게 가장 흔한 사고 경로예요. 테스트 코드라도 예외 없이 적용하는 게 좋아요.

2. 사용량 한도 걸어두기

Usage limits는 사고가 난 뒤에 설정하면 의미가 없어요. 첫날 낮은 금액으로 걸어두고, 실제 사용량을 보면서 올리는 순서가 안전합니다. 자동 충전은 사용 패턴이 익숙해진 뒤에 켜세요.

3. 프롬프트를 파일로 분리하기

코드 안에 긴 문자열로 박아두면 나중에 수정할 때마다 코드를 건드려야 해요. 프롬프트를 별도 텍스트 파일이나 변수로 빼두면 문구만 바꿔가며 결과를 비교하기 훨씬 편합니다.

입문자가 자주 하는 실수 5가지

1. ChatGPT Plus 결제하고 API도 된다고 생각하기

가장 흔한 오해예요. 두 서비스는 계정도 결제도 별개입니다. Plus를 쓰고 있어도 API는 별도로 충전해야 호출이 됩니다.

2. 큰 모델부터 시작하기

성능 좋은 모델이 결과도 좋을 거라 생각해서 처음부터 상위 모델을 쓰는 경우가 많아요. 대부분의 입문 단계 작업은 경량 모델로 충분하고, 품질이 아쉬울 때 올려도 늦지 않습니다. 순서를 반대로 하면 비용만 새요.

3. 응답 길이를 제한하지 않기

max_tokens를 지정하지 않으면 필요 이상으로 긴 답변이 돌아옵니다. 출력 토큰이 입력보다 단가가 높기 때문에 여기서 비용이 가장 많이 벌어져요. 원하는 길이를 프롬프트와 파라미터 양쪽에 명시하세요.

4. 대화 기록을 계속 쌓아 보내기

챗봇을 만들 때 이전 대화를 전부 붙여 보내면 호출할 때마다 입력 토큰이 눈덩이처럼 불어납니다. 최근 몇 개 대화만 유지하거나 앞부분을 요약해서 넘기는 방식으로 잘라내야 해요.

5. 에러 처리 없이 반복문 돌리기

수백 건을 한 번에 처리하는 코드를 에러 처리 없이 돌리면 중간에 한 번 실패했을 때 지금까지 결과가 통째로 날아갑니다. 처리할 때마다 결과를 파일에 저장하고, 실패한 항목은 따로 기록해두는 습관이 필요해요.

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

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

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

다음 단계로는 본인 업무에서 가장 자주 반복하는 작업 하나를 골라 자동화해보세요. 매일 손으로 정리하는 자료가 있다면 그게 첫 프로젝트로 가장 적합해요. 처음부터 완성도 높은 서비스를 만들려고 하면 시작 자체가 미뤄지니까, 열 건짜리 작은 스크립트로 먼저 돌려보고 결과를 확인한 다음 범위를 넓히는 순서를 권합니다. 그 과정에서 프롬프트를 다듬는 감각이 붙고, 어떤 모델이 본인 작업에 맞는지도 자연스럽게 알게 돼요.