“OPENAI_API_KEY” 발급, ChatGPT는 매일 쓰면서 API Key는 처음이신가요

들어가며

ChatGPT는 매일 쓰면서도 정작 OpenAI API Platform은 처음 열어보는 분들이 정말 많습니다. 저도 처음 개인 프로젝트에 GPT 기능을 붙이려고 했을 때, ChatGPT 로그인 정보로 어딘가에서 키를 받을 수 있을 줄 알았는데 전혀 다른 화면이 나와서 당황했던 기억이 있습니다. 검색을 해봐도 화면 구성이 계속 바뀌다 보니 예전 캡처와 지금 화면이 달라서 더 헷갈리기만 했습니다. 그래서 오늘은 지금 시점 기준으로 OPENAI_API_KEY를 발급받는 과정을 처음부터 끝까지 정리해보려고 합니다. 이미 여러 번 발급해본 분들도 있겠지만, 처음 시도하는 분이라면 이 글 하나로 막힘 없이 끝낼 수 있도록 준비했습니다.

ChatGPT와 OpenAI API Platform은 다른 서비스입니다

가장 먼저 헷갈리는 부분이 바로 이 지점입니다. 우리가 평소에 쓰는 ChatGPT 웹사이트나 앱은 일반 사용자를 위한 대화형 서비스이고, 요금제도 월 구독 형태입니다. 반면 API Key는 개발자가 자신의 프로그램이나 웹사이트, 자동화 도구에 GPT 모델을 직접 연결할 때 사용하는 인증 수단입니다. 즉 ChatGPT Plus를 구독하고 있다고 해서 API 이용료가 함께 포함되는 것은 아니며, API는 사용한 토큰량에 따라 별도로 과금됩니다. 이 부분을 모르고 있다가 나중에 두 가지 요금이 따로 청구되는 것을 보고 놀라는 경우도 종종 있으니 미리 알아두시는 것이 좋습니다.

키 발급 전에 챙겨야 할 두 가지

API Key를 만들기 전에 준비해야 할 것은 크게 두 가지입니다. 첫 번째는 OpenAI 계정입니다. 이메일이나 구글, 마이크로소프트 계정으로 간단히 가입할 수 있습니다. 두 번째는 결제 수단 등록입니다. OpenAI API는 일정 금액의 무료 크레딧을 제공하지 않는 시기도 있고, 정책이 자주 바뀌기 때문에 결제 카드를 미리 등록해두지 않으면 키를 만들어도 실제 호출 단계에서 막히는 경우가 있습니다. Billing 메뉴에서 카드 정보를 등록하고 사용 한도를 설정해두면 예상치 못한 과금도 방지할 수 있어 안전합니다.

OPENAI_API_KEY 생성하는 방법

준비가 끝났다면 이제 본격적으로 키를 발급받을 차례입니다. 순서는 다음과 같습니다.

1. platform.openai.com에 접속해 로그인합니다.
2. 좌측 상단 또는 사이드바에서 계정 설정으로 들어가 Billing 항목에 결제 카드를 등록합니다.
3. 사이드바에서 API Keys 메뉴를 찾아 클릭합니다.
4. Create new secret key 버튼을 눌러 키 이름을 입력하고 생성합니다.
5. 생성된 키는 이 화면을 벗어나면 다시 볼 수 없으므로 반드시 그 자리에서 복사해 안전한 곳에 저장합니다.

여기서 가장 중요한 것은 마지막 단계입니다. OpenAI는 보안을 위해 키 전체 값을 단 한 번만 보여주고, 이후에는 앞뒤 일부 글자만 마스킹된 형태로 표시합니다. 복사하지 못하고 창을 닫아버리면 그 키는 사용할 수 없게 되고, 처음부터 새 키를 다시 만들어야 합니다.

발급받은 키, 이렇게 관리하세요

키를 발급받았다고 끝이 아닙니다. 오히려 여기서부터가 진짜 중요합니다. API Key는 비밀번호와 마찬가지로 취급해야 하는 정보입니다. 코드 파일 안에 문자열로 그대로 적어두면, 그 코드를 깃허브 같은 공개 저장소에 올렸을 때 누구나 내 키를 가져다 쓸 수 있게 됩니다. 실제로 이런 방식으로 키가 유출되어 예상치 못한 요금이 청구된 사례가 꾸준히 보고되고 있습니다. 그래서 보통은 .env 파일에 키 값을 따로 저장하고, 이 파일을 .gitignore에 등록해 버전 관리 대상에서 제외하는 방식을 씁니다. 만약 실수로 키가 외부에 노출된 것 같다면 지체하지 말고 API Keys 화면에서 해당 키를 즉시 폐기하고 새 키를 발급받는 것이 가장 확실한 대처법입니다.

마무리

정리하면 OPENAI_API_KEY 발급 자체는 계정 생성, 결제 등록, 키 생성이라는 단순한 흐름으로 이루어져 있습니다. 다만 ChatGPT와 API가 별개의 서비스라는 점, 그리고 키가 노출되지 않도록 관리하는 습관을 들이는 것이 실제로는 더 중요한 부분입니다. 이 글을 참고해서 처음 API를 연동하시는 분들이 시행착오를 조금이라도 줄이셨으면 합니다.

참고

OpenAI 공식 플랫폼 문서(platform.openai.com)를 기준으로 작성했으며, 화면 구성은 서비스 업데이트에 따라 달라질 수 있습니다.