API 키 발급 자체는 몇 번 누르면 끝납니다. 중요한 건 발급 순서입니다. 한도를 걸기 전에 키를 만들어 코드에 넣으면, 사고가 났을 때 막을 것이 없습니다.
권장 순서
결제 수단 등록과 지출 한도 설정을 먼저 합니다. 자동 충전은 끄고 월 한도를 낮게 잡습니다.- 그 다음 키를 발급합니다.
- 키를 환경 변수에 넣고 코드에서 불러 씁니다.
- 작은 호출로 한 번 테스트해 요금이 얼마나 붙는지 대시보드에서 확인합니다.
순서를 뒤집으면 안 되는 이유는 단순합니다. 키가 살아 있는 동안은 호출이 가능하고, 한도가 없으면 그 호출에 상한이 없습니다.
키 발급
platform.openai.com에 로그인합니다.- API keys 메뉴로 이동합니다.
- 새 키 생성(Create new secret key)을 누릅니다.
- 키에 용도가 드러나는 이름을 붙입니다. 예: “블로그자동화-테스트”. 나중에 어느 키가 무엇인지 알아야 문제가 생긴 키만 끊을 수 있습니다.
- 생성된 키를 즉시 복사해 안전한 곳에 저장합니다. 이 화면을 닫으면 전체 값을 다시 볼 수 없습니다.
키는 비밀번호와 같다
키가 있으면 누구나 당신의 계정으로 요금을 발생시킬 수 있습니다. 공개 저장소, 채팅, 스크린샷에 키가 들어가지 않게 하십시오. 특히 화면 캡처를 공유할 때 키가 함께 찍히는 사고가 흔합니다.
노출됐다면 고민하지 말고 즉시 폐기(revoke)하고 새로 발급하십시오. 폐기한 키는 그 순간부터 호출이 막힙니다.
키를 코드에 직접 쓰지 않는 법
키를 소스에 적으면 그 파일을 공유하거나 저장소에 올리는 순간 유출됩니다. 환경 변수를 쓰면 코드와 키가 분리됩니다.
리눅스·맥 셸에서는 이렇게 넣습니다.
export OPENAI_API_KEY="발급받은키"
파이썬에서는 이렇게 읽습니다.
import os
key = os.environ["OPENAI_API_KEY"]
이렇게 하면 코드에는 키가 없고, 키를 바꿔도 코드를 고칠 필요가 없습니다.
용도별로 키를 나누는 이유
- 추적이 됩니다 — 요금이 어느 작업에서 나오는지 구분할 수 있습니다.
- 피해를 좁힐 수 있습니다 — 한 키가 유출돼도 그 키만 끊으면 됩니다. 키가 하나뿐이면 폐기 순간 모든 것이 멈춥니다.
- 정리가 됩니다 — 끝난 프로젝트의 키를 지우기 쉬워집니다.
확인 범위
메뉴 이름과 위치는 플랫폼 화면 구성을 기준으로 적었습니다. 개편으로 달라질 수 있으니 실제 화면을 우선하시기 바랍니다. 캡처를 확보하는 대로 단계별 이미지를 추가하겠습니다.
자주 묻는 질문
키를 잃어버렸습니다. 다시 볼 수 있나요?
없습니다. 생성 직후 한 번만 전체가 보입니다. 잃어버렸다면 그 키를 폐기하고 새로 발급하십시오.
키 하나로 여러 프로젝트를 써도 되나요?
동작은 합니다. 다만 유출 시 전부 끊어야 하고 요금 추적이 어렵습니다. 나누는 편이 낫습니다.
프로젝트나 조직 단위로 한도를 따로 걸 수 있나요?
플랫폼이 조직·프로젝트 구분을 제공합니다. 구체적인 한도 설정 범위는 설정 화면에서 확인하시기 바랍니다.