ChatGPT API 완전 가이드: 초보자부터 고급자까지

ChatGPT API를 활용하면 강력한 AI 애플리케이션을 구축할 수 있습니다. 이 가이드에서는 OpenAI API를 효과적으로 사용하는 방법을 알려드립니다.

ChatGPT API란?

ChatGPT API는 GPT-4 등 OpenAI 모델의 기능을 자신의 애플리케이션에 통합할 수 있는 프로그래밍 인터페이스입니다. ChatGPT.com 같은 사용자 인터페이스와 달리, API는 AI 모델을 완전히 제어할 수 있게 해줍니다.

API 사용의 장점:

• 프롬프트와 파라미터의 완전한 제어
• 자신의 제품에 통합 가능
• 사용량 기반 과금(pay-per-use)
• GPT-4o를 포함한 최신 모델 접근

초기 설정

1. API 키 발급

1. platform.openai.com 접속
2. 계정 생성 또는 로그인
3. API Keys → Create new secret key 선택
4. 키를 안전하게 보관 (생성 후 재확인 불가)

2. 라이브러리 설치

pip install openai python-dotenv

3. 환경 변수 설정

# .env 파일
OPENAI_API_KEY=sk-...

첫 번째 API 호출

from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()
client = OpenAI()

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "당신은 도움이 되는 AI 어시스턴트입니다."},
        {"role": "user", "content": "머신러닝을 3문장으로 설명해 주세요."}
    ],
    temperature=0.7,
    max_tokens=500
)

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

중요한 파라미터

고급 사용 패턴

멀티턴 대화

conversation = [
    {"role": "system", "content": "당신은 인내심 있는 수학 과외 교사입니다."}
]

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

print(chat("미적분의 미분이 무엇인가요?"))
print(chat("간단한 예를 들어주세요."))

스트리밍 응답

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "AI에 관한 시조를 지어주세요"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

구조화된 출력 (JSON)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{
        "role": "user",
        "content": "김철수, 30세, 서울 거주 정보를 JSON 형식으로 출력해 주세요"
    }],
    response_format={"type": "json_object"}
)

import json
data = json.loads(response.choices[0].message.content)

비용 관리

요금 안내 (2026년)

• GPT-4o-mini: 입력 $0.15/100만 토큰, 출력 $0.60/100만 토큰
• GPT-4o: 입력 $2.50/100만 토큰, 출력 $10.00/100만 토큰

비용 절감 팁:

• 작업에 맞는 모델 선택 (단순 작업은 gpt-4o-mini)
• max_tokens로 응답 길이 제한
• 프롬프트 캐싱 활용
• OpenAI 대시보드에서 사용량 모니터링

보안 및 베스트 프랙티스

• API 키를 코드에 직접 입력하지 마세요 — 항상 환경 변수 사용
• 사용자 입력 검증 후 API에 전송
• 레이트 리미팅 — 요청 간 적절한 대기 시간
• 오류 처리 — 타임아웃과 네트워크 오류 처리

import time
from openai import RateLimitError

def safe_api_call(messages, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model="gpt-4o-mini",
                messages=messages
            )
        except RateLimitError:
            time.sleep(2 ** attempt)
    raise Exception("여러 번 시도 후 실패")

ChatGPT API로 AI 앱을 구축하고 싶으신가요? LearnGeni의 완전 가이드는 기초부터 프로덕션 배포까지 모두 다룹니다. 모든 가이드 보기.