api 키를 발급하는 초심자에게 추천할 방향성이 있을까?

Pippa· warm06/18/2026

안녕하세요, Erik Choi님. 피파예요.

API key 첫 발을 내딛는 단계라면, 제일 먼저 잡아야 할 방향은 “멋진 활용”보다 “안전한 습관”이에요. API key는 비밀번호에 가까워요. 모델을 쓰는 열쇠이기도 하지만, 잘못 노출되면 비용이 실제로 나갈 수 있는 열쇠거든요.

제가 추천하는 기본 방향은 이렇게예요.

처음에는 하나의 개인 실험용 key로 충분해요. 다만 나중에 앱이나 서버에 붙이기 시작하면 용도별로 key를 나누는 게 좋아요.

이렇게 나누면 문제가 생겼을 때 해당 key만 폐기하면 돼요. 하나의 master key를 모든 곳에 박아두면, 나중에 어디서 새는지 찾기도 어렵고 끊기도 어려워요.

예를 들면 이런 식이에요.

이름에 들어가면 좋은 정보는 세 가지예요.

처음엔 사소해 보이지만, key가 5개만 넘어가도 “이거 지워도 되나?”가 바로 문제 됩니다. 미래의 자신에게 친절하게 이름 붙이는 게 유지보수의 시작이에요.

이건 초심자에게 제일 중요한 규칙이에요.

나쁜 예:

client = OpenAI(api_key="sk-...")

좋은 예:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

key는 코드가 아니라 환경변수나 .env 파일에 두세요. 그리고 .env는 절대 Git에 올리지 않게 .gitignore에 넣어야 해요.

처음 프로젝트를 만든다면 최소한 이렇게 해두면 좋아요.

.env

# .gitignore
.env

그리고 예시 파일만 따로 둡니다.

# .env.example
OPENAI_API_KEY=put-your-key-here

진짜 key는 .env, 남에게 보여줄 안내는 .env.example. 이 구분만 익혀도 초심자 단계에서 큰 사고 하나는 피할 수 있어요.

처음 API를 쓰면 “내가 버튼을 한 번 눌렀을 뿐인데 비용이 얼마나 나가지?” 감각이 아직 없어요. 그래서 가능하면 다음을 설정하세요.

처음 실험은 아주 작은 한도로 시작해도 됩니다. 많이 쓰는 것보다 중요한 건, 비용 구조를 몸으로 익히는 거예요.

temperature를 배우려면 같은 prompt를 여러 번 돌려보는 게 좋아요. 다만 이때도 입력과 출력을 기록해야 배움이 남아요.