AI 초보자 QnA
질문
OpenAI API 프로젝트에 팀원을 어떻게 추가하고 역할을 정하나요?
답변
팀원이 아직 OpenAI API 조직에 없다면 조직 구성원으로 먼저 초대한 뒤, 필요한 프로젝트의 Members에서 추가하세요. 이미 조직에 들어온 사용자는 프로젝트에 바로 넣을 수 있습니다.
기본 프로젝트 역할은 Owner와 Member로 나뉩니다. API 요청과 프로젝트 리소스 사용이 목적이라면 Member부터 검토하고, 구성원·설정·지출 한도까지 관리해야 할 사람에게만 Owner를 맡기는 편이 안전합니다.
짧게 답하면
조직 확인 → 팀원 초대·수락 → 대상 프로젝트 선택 → Member로 추가 → 필요한 작업과 접근 범위 확인 순서로 진행하세요. 프로젝트 관리 권한이 꼭 필요한 경우에만 Owner로 바꿉니다.
조직 구성원
OpenAI API 조직에 들어온 사용자입니다. 프로젝트 추가 전에 조직 초대가 필요할 수 있습니다.
Project Member
해당 프로젝트에서 API 요청, 리소스 사용, 프로젝트 키 생성을 할 수 있습니다.
Project Owner
Member의 작업에 더해 프로젝트 구성원과 설정, 지출 한도를 관리할 수 있습니다.
처음 쓰는 사람 기준으로 설명하면
OpenAI API에서는 조직과 프로젝트가 서로 다른 범위입니다. 조직은 결제와 전체 사용자를 묶는 상위 공간이고, 프로젝트는 API 키·파일·모델 작업·사용량을 작업별로 나누는 공간입니다. 조직에 초대했다고 모든 프로젝트가 자동으로 보이는 것은 아닙니다.
새 조직 구성원은 기본 프로젝트에 자동 추가되지 않을 수 있습니다. 조직 초대 과정에서 기본 프로젝트 초대를 선택하거나, 초대를 수락한 뒤 해당 프로젝트에서 따로 추가하세요. 프로젝트가 보이지 않는다면 새 API 키를 만들기 전에 계정, 조직, 프로젝트 구성원 여부를 차례로 확인합니다.
기본 역할 외에 RBAC를 사용하는 조직은 더 세밀한 역할을 만들 수 있습니다. 이때 사용자가 할 수 있는 일은 맡은 역할들의 권한을 합쳐 판단합니다. API 키에 권한이 있어도 사용자 역할에 같은 작업 권한이 없으면 요청이 허용되지 않을 수 있습니다.
한 줄 정리: 사람을 조직에 넣는 일과 특정 프로젝트의 작업 권한을 주는 일은 나뉘며, 처음에는 필요한 프로젝트의 최소 역할만 맡기면 됩니다.
바로 따라 해보기
1단계. 올바른 조직과 초대 상태를 확인합니다.
API Platform에서 팀이 결제하고 사용하는 조직을 고르세요. 팀원이 목록에 없으면 조직의 Members에서 초대하고, 상대가 초대를 수락했는지 확인합니다.
2단계. 필요한 프로젝트에 Member로 추가합니다.
대상 프로젝트의 Members에서 팀원을 고르고 Member 역할로 시작하세요. 프로젝트를 만들거나 설정·구성원을 관리해야 하는 담당자라면 Owner가 필요한지 따로 검토합니다.
3단계. 팀원 계정으로 실제 접근을 확인합니다.
팀원이 자신의 계정으로 로그인해 프로젝트가 보이는지 확인하고, 필요한 API 키를 직접 만들게 하세요. 작은 요청을 보내 본 뒤 불필요한 프로젝트나 관리 권한은 남기지 않습니다.
주의할 점
팀원을 추가하려고 내 API 키나 관리자 키를 전달하면 안 됩니다. 사람마다 자신의 계정과 프로젝트 키를 사용해야 누가 어떤 권한으로 작업했는지 구분하기 쉽습니다.
프로젝트 작업만 할 사람에게 조직 Owner나 프로젝트 Owner를 바로 줍니다. 결제·구성원·설정 관리가 필요하지 않다면 더 작은 역할부터 시작하세요.
초대가 보이지 않는다는 이유로 조직과 프로젝트를 확인하지 않고 새 계정을 반복해서 만듭니다. 초대 이메일, 로그인 주소, 선택한 조직을 먼저 대조하세요.
퇴사·업무 변경 뒤에도 예전 프로젝트 권한과 API 키를 그대로 둡니다. 구성원 제거와 키 폐기를 각각 확인하고 사용량도 살펴보세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
구성원 관리는 API Platform 웹사이트
브라우저에서 조직 Members와 프로젝트 Members를 차례로 확인하세요. 초대 상태, 역할, 프로젝트 범위를 한 화면씩 나눠 보는 것이 정확합니다.
ChatGPT 앱의 멤버는 별도
ChatGPT 워크스페이스 역할과 API Platform 조직·프로젝트 역할은 서로 옮겨지지 않습니다. API 팀원을 추가할 때는 ChatGPT 앱이 아니라 API Platform을 엽니다.
같이 보면 좋은 질문
확인한 공식 자료
OpenAI 공식 도움말 — Managing projects in the API platform — 조직 구성원을 프로젝트에 추가하는 순서와 Project Owner·Member의 기본 권한 차이를 확인했습니다.
OpenAI 공식 도움말 — API 조직 구성원 관리 — 조직에서 구성원을 초대·변경·삭제하는 위치와 Owner·Reader 범위를 확인했습니다.
OpenAI API 공식 문서 — Manage permissions in the OpenAI platform — 조직·프로젝트 역할의 범위, 권한 합산 방식과 API 키 권한 확인 기준을 확인했습니다.
OpenAI API 공식 문서 — Create project user — 사용자를 프로젝트에 추가하려면 조직 구성원이어야 하며 역할을 지정해야 하는 조건을 확인했습니다.
