ChatGPT API 사용법 완전 가이드 2026 — Python 연동·비용 계산·실전 예제 10가지

ChatGPT API — ChatGPT 웹에서 복사·붙여넣기하던 시대는 끝났습니다. API를 직접 연결하면 자동화·대량 처리·나만의 AI 서비스 구축이 가능합니다. Python 5줄로 시작하는 방법을 완전 정리합니다.

ChatGPT API란 — 웹 vs API 차이

STEP 1. OpenAI API 키 발급

1. platform.openai.com 접속 → 회원가입 또는 로그인
2. 우측 상단 프로필 → API keys 클릭
3. Create new secret key → 키 이름 입력 → Create secret key
4. 생성된 키를 복사해 안전한 곳에 저장 (다시 볼 수 없음)
5. 결제 수단 등록: Settings → Billing → Add payment method

보안 주의: API 키는 절대 GitHub에 올리거나 공개하지 마세요. 환경 변수(.env)에 저장하는 것이 기본입니다.

STEP 2. Python 환경 설정

# 패키지 설치
pip install openai python-dotenv

# .env 파일 생성 (프로젝트 루트에)
OPENAI_API_KEY=sk-your-api-key-here

STEP 3. 첫 번째 API 호출 — 5줄 코드

from openai import OpenAI
client = OpenAI()  # OPENAI_API_KEY 환경 변수 자동 읽기

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "안녕하세요! 간단히 소개해 주세요."}]
)
print(response.choices[0].message.content)

모델 선택 가이드 — gpt-4o vs gpt-4o-mini

대부분의 용도는 gpt-4o-mini로 충분합니다. gpt-4o 대비 성능은 85% 수준이지만 비용은 1/15입니다.

실전 예제 — 자주 쓰는 패턴 5가지

예제 1. 시스템 프롬프트로 역할 고정

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "당신은 친절한 한국어 번역 전문가입니다."},
        {"role": "user", "content": "Please translate: 'Hello, world!'"}
    ]
)

예제 2. 대화 히스토리 유지

history = [{"role": "system", "content": "당신은 유용한 어시스턴트입니다."}]

def chat(user_message):
    history.append({"role": "user", "content": user_message})
    response = client.chat.completions.create(model="gpt-4o-mini", messages=history)
    assistant_message = response.choices[0].message.content
    history.append({"role": "assistant", "content": assistant_message})
    return assistant_message

예제 3. 스트리밍 출력 (타이핑 효과)

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "긴 글을 써 주세요."}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

예제 4. JSON 구조화 출력

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "사과 효능 3가지를 JSON으로: [{"효능": ..., "근거": ...}]"}],
    response_format={"type": "json_object"}
)
import json
data = json.loads(response.choices[0].message.content)

예제 5. 토큰 사용량 확인

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "안녕하세요"}]
)
usage = response.usage
print(f"입력: {usage.prompt_tokens}, 출력: {usage.completion_tokens}, 합계: {usage.total_tokens}")

비용 계산 방법

토큰은 대략 한글 기준 1.5~2자에 1토큰, 영어는 4글자에 1토큰입니다.

자주 발생하는 오류 해결