“OpenAI API Secret Key”, 잃어버렸다면? 지금 바로 새로 발급하는 방법

들어가며

OpenAI API를 사용하려는데 이미 발급받은 Secret Key가 보이지 않으시나요? 걱정하지 마세요. OpenAI API Key는 보안상 기존 Secret Key를 다시 확인할 수 없기 때문에 새로운 키를 발급해야 합니다. 이 글에서는 API Key의 Name, Status, Tracking ID, Secret Key, 만료일, Last used, Permissions의 의미부터 새 Secret Key 발급 방법과 Java 프로젝트에서 안전하게 API Key를 사용하는 방법까지 초보자도 쉽게 이해할 수 있도록 단계별로 설명합니다.

1️⃣ 현재 보이는 항목들의 의미

아마 API Keys 화면에서 다음과 비슷한 항목을 보고 계실 겁니다.

항목	의미
Name	API Key의 이름
Status	현재 키 상태
Tracking ID	키를 식별하기 위한 추적용 ID
Secret Key	실제 API 인증에 사용하는 비밀 키
Created	키 생성일
만료일	키가 자동으로 만료되는 날짜
Last used	마지막으로 사용된 날짜
Created by	키를 생성한 사용자
Permissions	API 사용 권한

하나씩 설명하겠습니다.

2️⃣ Name (이름) ⭐

이것은 API Key를 구분하기 위한 이름입니다.

예를 들어 지금 만들고 있는 프로젝트가 AI 경기 분석 프로그램이라면:

sports-analysis-java

또는

ai-match-analysis

처럼 만들면 됩니다.

추천

Sports-Analysis-Java

나중에 API Key가 여러 개 생겨도 어떤 프로그램에서 사용하는지 쉽게 알 수 있습니다.

3️⃣ Status (상태)

API Key가 현재 사용할 수 있는 상태인지 표시합니다.

예)

Active

→ 정상적으로 사용 가능

또는:

Revoked

→ 폐기된 키, 더 이상 사용 불가

따라서 새 키를 만들었다면:

Status = Active

인지 확인하면 됩니다.

4️⃣ Tracking ID

이것은 키 자체의 Secret Key가 아닙니다.

예를 들어

Tracking ID: abc123...

이런 값이 보일 수 있습니다.

이 값은 OpenAI에서 특정 키를 식별하거나 사용량·문제 추적 등에 활용하는 식별 정보입니다.

⚠️ 중요한 점

Tracking ID ≠ Secret Key

따라서 Java 코드의:

OPENAI_API_KEY

에 넣으면 안 됩니다.

5️⃣ Secret Key ⭐⭐⭐⭐⭐

가장 중요합니다.

보통 이런 형태입니다.

sk-xxxxxxxxxxxxxxxxxxxxxxxx

또는 프로젝트 키 형식에 따라 다른 접두사가 보일 수 있습니다.

이 값이 바로 Java 프로그램에서 사용하는:

OPENAI_API_KEY

입니다.

하지만 중요한 문제는:

이미 생성한 키의 전체 Secret Key를 나중에 다시 확인할 수 없습니다.

OpenAI 공식 안내에 따르면 Secret Key는 생성 시 한 번만 전체 표시됩니다. 잃어버렸다면 새 키를 생성해야 합니다.

6️⃣ Created (생성일)

예)

Created
2026-09-01

이 API Key를 언제 만들었는지 보여줍니다.

관리용 정보입니다.

7️⃣ 만료일 (Expiration)

키를 언제까지 사용할 수 있는지 설정하는 항목입니다.

예)

Never

→ 자동 만료 없음

또는

2027-09-01

→ 해당 날짜 이후 사용 불가

개인 개발용 추천

현재 Java 프로그램을 개발 중이라면 보통

90일

또는 프로젝트가 장기간 운영된다면 키 관리 정책에 맞춰 설정하는 것이 좋습니다.

개인 PC 개발 단계에서는 자동 만료를 설정하면 보안상 더 좋지만, 만료 후 프로그램 키를 교체해야 한다는 점은 기억해야 합니다.

8️⃣ Last used

예)

Last used
Never

→ 아직 한 번도 사용하지 않음

또는

2026-09-01

→ 마지막 API 호출 날짜

Java 프로그램에서 API를 호출한 후 확인하면 사용 기록이 표시될 수 있습니다.

이 항목은 아주 유용합니다.

예를 들어 API Key가 3개 있는데:

Key-A → Last used: 오늘
Key-B → Last used: 6개월 전
Key-C → Last used: Never

그러면 사용하지 않는 키를 정리할 수 있습니다.

9️⃣ Created by

이 API Key를 만든 계정을 표시합니다.

개인 계정으로 사용한다면 보통 본인의 계정 정보가 표시됩니다.

팀 프로젝트라면

홍길동

처럼 키를 만든 사람이 표시될 수 있습니다.

🔟 Permissions (권한) ⭐⭐⭐

API Key가 무엇을 할 수 있는지 설정합니다.

OpenAI API Key에는 일반적으로 다음 권한 방식이 있습니다.

① All

All

모든 권한을 허용합니다.

개발 초기에는 편리하지만 권한 범위가 넓습니다.

② Restricted ⭐ 추천

Restricted

필요한 API 기능만 허용합니다.

예를 들어

Responses API → Write 허용

처럼 필요한 기능만 사용할 수 있습니다.

공식적으로도 API 키에 대해 All / Restricted / Read Only 권한 수준을 제공하며, Restricted에서는 리소스·엔드포인트별 권한을 조정할 수 있습니다.

③ Read Only

Read Only

읽기만 가능합니다.