AI

OpenAi Api Key 생성 시, Permissions 항목 의미 이해

cloudlim 2025. 10. 6. 16:12

OpenAi platform에서 api key를 발급 받을 수 있다. 

발급 받을 때는 개별 Key별로 권한을 설정할 수 있다.

Key는 말 그대로 열쇠라고 생각하면 된다.

어떤 Key를 들고 OpenAi에 접근하냐에 따라 권한을 달리 줄 수 있다는 의미이다.

 

 

2025년 10월 5일 기준, 설정 가능한 항목은 8개이다. 그리고 각 항목별로 설정하는 범위가 조금 다르다.

 

1. Models: OpenAI에서 사용할 수 있는 모든 모델 목록을 불러올 수 있는가에 대한 설정
- None: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정이 사용할 수 있는 모델 목록을 조회할 수 없다

*api를 통해 특정 모델로만 접근하고, 모델명을 직접 명시할 수 있는 경우, None 사용
- Read: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정이 사용할 수 있는 모델 목록을 조회할 수 있다

*n8n의 Credentials로 api key 등록할 때는 Read 권한을 줘야 한다. 

 

2. Model Capabilities: LLM에게 명령할 수 있는가에 대한 설정
- None: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정이 사용할 수 있는 생성형 모델들에게 명령할 수 없다
- Write: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정이 사용할 수 있는 생성형 모델들에게 명령할 수 있다

 

3. Assistants: GPT에서 설정 및 생성한 Assistant에 대한 접근 권한 설정
- None: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 GPT Assistant를 사용할 수 없다
- Read: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 GPT Assistant의 최근 출력 결과나 설정 정보 등을 읽어올 수 있다
- Write: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 GPT Assistant에게 명령할 수 있다

 

4. Threads: 대화 히스토리에 대한 접근 권한 설정
- None: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 이전 대화내역 혹은 명령 및 출력 이력을 불러올 수 없다 (Thread API 사용 불가능 하고, 1회성 대화만 가능 = chatCompletion만 가능)
- Read: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 이전 대화내역 혹은 명령 및 출력 이력을 보기만 할 수 있다 (이전 대화 내역 기반으로 명령 불가)
- Write: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 이전 대화내역 혹은 명령 및 출력 이력을 불러올 수 있고 대화를 이어갈 수 있다 (이전 대화 내역 기반 명령 가능)


5. Evals: 모델 성능 평가에 대한 접근 권한 설정
- None: 해당 api key로 접근할 경우,  모델 평가 기능에 접근 불가
- Read: 해당 api key로 접근할 경우,  모델 평가 결과 조회 가능
- Write: 해당 api key로 접근할 경우,  모델 평가 가능


6. Fine-tuning: 커스텀 모델 관련 권한 설정
- None: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 커스텀 모델에 접근할 수 없고, 커스텀 모델을 생성할 수 없다.
- Read: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 커스텀 모델에 접근할 수 있으나, 커스텀 모델을 생성할 수는 없다.
- Write: 해당 api key로 접근할 경우, key 발급 주체가 되는 계정의 커스텀 모델에 접근할 수 있고, 커스텀 모델을 생성할 수도 있다


7. Files: 모델에게 파일 업로드 또는 파일 다운로드에 대한 권한 설정
- None: 해당 api key로 접근할 경우, 파일을 업로드하거나 이미 업로드된 파일을 다운로드할 수 없다.
- Read: 해당 api key로 접근할 경우, 파일을 업로드할 수 없으나 이미 업로드된 파일을 다운로드할 수 있다.
- Write: 해당 api key로 접근할 경우, 파일을 업로드할 수 있고 이미 업로드된 파일을 다운로드할 수 있다.


8. Responses API: 텍스트, 이미지, 오디오 응답을 한번에 출력할 수 있는 통합 인터페이스 권한 설정 (멀티 모달)
- None: 해당 api key로 접근할 경우, 텍스트와 이미지 등을 동시에 명령할 수 없고 출력 결과도 복합 양식(예: 텍스트+이미지)으로 출력될 수 없다.
- Read: 현재 실질적 동작은 거의 없음 (응답 로그/결과만 조회용으로 설계 중)
- Write: 해당 api key로 접근할 경우, 텍스트와 이미지 등을 동시에 명령할 수 있고, 출력 결과도 복합 양식으로 출력될 수 있다.

*GPT4o 사용 시 멀티 모달 기능 사용하려면, Write 권한 필수