API 키, 한 문장으로
API 키는 프로그램이 어떤 서비스를 쓸 때 내미는 비밀번호 같은 출입증입니다. "이건 내 계정에서 보내는 요청이야"를 증명하는 문자열이에요. 보통 sk-... 처럼 긴 무작위 글자입니다.
먼저, API가 뭔데?
API는 프로그램끼리 대화하는 창구입니다. 사람은 화면(앱)으로 서비스를 쓰지만, 코드는 API로 씁니다.
예: ChatGPT를 사람은 채팅 화면에서 쓰지만, 내 프로그램이 자동으로 쓰려면 OpenAI API를 호출합니다. 그때 "누가 부르는지" 확인하려고 API 키가 필요합니다.
왜 필요한가
- 인증: 아무나 못 쓰게, 내 계정 요청임을 확인
- 과금: 사용량(토큰)을 내 계정에 정확히 청구 (토큰이란?)
- 제한: 한도·권한을 키 단위로 관리
어디서 얻나
각 서비스의 개발자 설정에서 발급합니다.
- OpenAI: platform.openai.com → API keys
- Anthropic(Claude): console.anthropic.com → API keys
- 발급 즉시 한 번만 보여주는 경우가 많으니 복사해서 안전히 보관
안전하게 다루기 (중요)
API 키가 새면 남이 내 돈으로 AI를 쓸 수 있습니다. 그래서:
- 코드에 직접 적지 마라. 깃허브에 올라가면 봇이 몇 분 만에 훔쳐 갑니다.
- 환경변수(.env) 에 넣고,
.gitignore로 제외하세요.
- 노출됐다 싶으면 즉시 재발급(rotate).
- 사용 한도(usage limit)를 걸어두면 사고 피해를 줄입니다.
구독 vs API 키
도구(Cursor 등)는 보통 두 방식이 있습니다.
- 구독: 정액 내고 편하게. 입문에 추천.
- 내 API 키 입력: 쓴 만큼 과금. 많이 쓰거나 세밀히 통제하고 싶을 때.
처음이라면 구독이나 무료 플랜으로 충분합니다. API 키는 "내 프로그램이 AI를 자동으로 불러야 할 때" 본격적으로 필요해집니다.