OpenAI API 키 발급과 환경 변수 보안 설정 방법

API 키 발급 전 확인 사항

OpenAI API 키는 Organization Settings > API keys 메뉴에서 발급합니다. 개인 계정과 조직 계정의 권한이 다르며, 조직 계정은 관리자 승인이 필요합니다.

조직 계정에서 API 키를 발급하려면 Organization Settings > Members에서 관리자 권한을 확인합니다. 관리자 권한이 없으면 키 발급 버튼이 표시되지 않습니다.

API 키 발급 절차

1. OpenAI 계정에 로그인합니다.
2. 오른쪽 상단 프로필 아이콘을 클릭한 후 Settings를 선택합니다.
3. 왼쪽 메뉴에서 API keys를 선택합니다.
4. Create new secret key 버튼을 클릭합니다.
5. 키 이름을 입력하고 Create secret key를 클릭합니다.
6. 생성된 키를 즉시 복사하여 안전한 곳에 저장합니다.

키를 복사하지 않고 페이지를 닫으면 다시 확인할 수 없으므로, 반드시 복사 후 저장합니다. 키는 Organization Settings > API keys에서 언제든지 재발급할 수 있지만, 이전 키는 자동으로 무효화됩니다.

환경 변수 설정

API 키는 코드에 직접 입력하지 않고 환경 변수로 저장합니다. 환경 변수 이름은 OPENAI_API_KEY로 통일합니다.

macOS/Linux

# 터미널에 입력

nano ~/.zshrc  # 또는 ~/.bashrc

# 파일 맨 아래에 추가

export OPENAI_API_KEY="발급받은_API_키"

# 저장 후 적용

source ~/.zshrc  # 또는 source ~/.bashrc

Windows (PowerShell)

# PowerShell에 입력

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', '발급받은_API_키', 'User')

# 적용 확인

$env:OPENAI_API_KEY

환경 변수에 키를 저장하면 코드에서 os.getenv('OPENAI_API_KEY') 또는 process.env.OPENAI_API_KEY로 불러올 수 있습니다. 환경 변수 이름은 대소문자를 구분하지 않지만, 통일성을 위해 OPENAI_API_KEY를 권장합니다.

보안 정책과 권한 관리

OpenAI API 키는 기본적으로 읽기/쓰기 권한을 가집니다. 조직 계정에서는 관리자가 API 키에 대한 접근 정책을 설정할 수 있습니다.

• 기본 권한: 모델 호출, 파일 업로드/다운로드, 사용량 조회
• 제한된 권한: 모델 호출만 허용(읽기 전용)
• 사용량 제한: 조직 관리자가 API 키당 일일/월간 사용량을 설정할 수 있음

조직 계정에서 API 키를 발급받은 후에는 Organization Settings > API keys > Usage limits에서 사용량을 설정합니다. 사용량 제한을 초과하면 API 호출이 거부됩니다.

키 노출 시 즉시 조치

API 키가 노출된 경우 다음 단계를 즉시 수행합니다.

Organization Settings > API keys로 이동합니다. Revoke 버튼을 클릭하여 해당 키를 무효화합니다. 환경 변수에서 해당 키를 삭제합니다.

코드에서 환경 변수 이름을 OPENAI_API_KEY_NEW로 변경하고, 새로운 키를 발급받은 후 환경 변수에 저장합니다. 모든 애플리케이션에서 환경 변수 이름을 OPENAI_API_KEY_NEW로 변경합니다.

API 호출 시 오류 진단

API 호출 중 발생하는 오류는 다음 기준으로 구분합니다.

401 Unauthorized: API 키가 잘못되었거나 무효화됨. - 확인 방법: Organization Settings > API keys에서 키 상태 확인. - 조치: 키를 재발급하고 환경 변수를 업데이트.

429 Too Many Requests: 사용량 제한 초과. - 확인 방법: Organization Settings > API keys > Usage limits에서 현재 사용량 확인. - 조치: 관리자에게 사용량 증가 요청 또는 일정 시간 대기.

403 Permission Denied: 권한 부족. - 확인 방법: Organization Settings > Members에서 사용자 권한 확인. - 조치: 관리자에게 권한 요청.

401 오류가 발생하면 환경 변수에 저장된 키가 최신 상태인지 확인합니다. 환경 변수 이름이 OPENAI_API_KEY와 일치하는지 확인하고, 대소문자 오류가 없는지 검토합니다.

완료 검증

API 키 발급과 환경 변수 설정이 완료되었는지 확인합니다.

터미널 또는 PowerShell에서 환경 변수 확인. ```bash. echo $OPENAI_API_KEY # macOS/Linux.

. powershell. $env:OPENAI_API_KEY # Windows.

. API 호출 테스트. python.

import os. from openai import OpenAI.

client = OpenAI(api_key=os.getenv('OPENAI_API_KEY')) response = client.models.list() print(response)

3. Organization Settings > API keys에서 키 상태가 Active로 표시되는지 확인

API 호출이 성공하면 모델 목록이 출력됩니다. 출력되지 않으면 환경 변수 이름이나 키 값이 올바른지 재확인합니다.

## FAQ

### 개인 계정에서 API 키를 발급했는데 조직 계정으로 전환할 수 있나요?

아니요. 개인 계정과 조직 계정은 분리되어 있습니다. 조직 계정으로 전환하려면 새로운 조직을 생성하거나 기존 조직에 가입해야 합니다. 조직 가입은 Organization Settings > General > Invite members에서 관리자에게 요청할 수 있습니다.

### API 키를 발급했는데 Organization Settings에 표시되지 않나요?

개인 계정의 API 키는 Settings > API keys에 표시됩니다. Organization Settings > API keys는 조직 계정에서만 접근할 수 있습니다. 계정 유형을 확인하려면 오른쪽 상단 프로필 아이콘 > Settings > General에서 확인합니다.

### 환경 변수를 설정했는데 API 호출 시 401 오류가 발생합니다

환경 변수 이름이 OPENAI_API_KEY와 정확히 일치하는지 확인합니다. 대소문자 오류가 없으며, 환경 변수가 적용된 터미널에서 API 호출을 수행하는지 확인합니다. 터미널을 새로 열면 환경 변수가 적용되지 않을 수 있으므로, source 명령으로 적용을 확인합니다.

### 조직 계정에서 API 키 사용량을 초과했습니다. 어떻게 해야 하나요?

Organization Settings > API keys > Usage limits에서 현재 사용량을 확인합니다. 사용량 제한을 초과한 경우 관리자에게 사용량 증가 요청을 제출합니다. 관리자는 Organization Settings > Billing > Usage limits에서 제한을 조정할 수 있습니다.

### API 키를 무효화했는데도 사용량이 청구되고 있습니다