API 플랫폼에서 프로젝트 관리하기

프로젝트는 고객이 작업을 체계화할 수 있도록 하는 것을 목표로 합니다. 조직은 액세스 및 한도를 관리하고, 서비스 계정(UI를 통해)을 프로비저닝하며, 프로젝트 내 제한된 범위(예: 모델, 기능, 스레드, 어시스턴트, 파인튜닝, 저장소 등)에 대해 사용량을 추적할 수 있습니다. 사용량 활동은 프로젝트별로 나눠 볼 수 있으며, 사용자는 프로젝트별 청구를 확인하고 예산을 설정할 수 있습니다.

조직 소유자는 Projects 페이지에서 모든 활성 및 보관된 프로젝트를 볼 수 있습니다. API 플랫폼의 사용자 역할 및 권한에 대해 자세히 알아보세요.

누가 프로젝트를 만들 수 있나요?

조직 소유자만 프로젝트를 만들 수 있습니다. 자세한 내용은 역할 및 권한을 참조하세요.

조직 간 전환하려면 페이지 왼쪽 상단의 조직 이름 위에 마우스를 올리고 목록에서 조직을 선택하세요:

통합 청구 요금제를 사용하는 조직의 경우 하위 조직은 별도로 식별됩니다. 하위 조직 내에서는 프로젝트를 만들 수 없습니다.

프로젝트는 어떻게 작동하나요?

모든 조직에는 삭제할 수 없는 “기본 프로젝트”가 포함되어 있습니다. rate limit, 가상 모델 권한, 지출 예산(2024년 11월 기준)을 구성할 수 있습니다. 조직의 전체 구성을 상속하므로 멤버나 서비스 계정을 직접 추가할 수는 없습니다.

프로젝트를 만들려면 어떻게 하나요?

먼저 페이지 왼쪽 모서리의 프로젝트 이름 위에 마우스를 올리고 Create project를 선택하세요.

프로젝트의 이름, 설명, 웹사이트를 입력한 다음 Create를 선택하세요.

프로젝트에 사용자를 추가하려면 어떻게 하나요?

새로 추가된 조직 멤버는 “기본 프로젝트”에 자동으로 추가되지 않습니다. 새 멤버는 조직에 초대할 때("기본 프로젝트에 초대" 체크박스 활성화) 또는 멤버가 조직 초대를 수락한 후 프로젝트에 초대할 수 있습니다.

Admin API를 통해 초대한 사용자는 /organization/invites 엔드포인트에 설명된 규칙을 따릅니다.

UI 또는 Admin API를 통해 프로젝트에 사용자를 초대할 때 오류가 발생하면, 초대를 다시 보내기 전에 먼저 대상 프로젝트가 존재하고 보관 처리되지 않았는지 확인하세요.

조직 소유자는 조직 내에서 생성된 새 프로젝트에 자동으로 소유자로 추가됩니다.

조직과 프로젝트 내의 다양한 사용자 역할은 무엇이며, 각각 어떤 권한이 있나요?

조직에는 ‘owner’와 ‘reader’ 역할이 있는 반면, 프로젝트에는 ‘owner’와 ‘member’ 역할이 있습니다. 프로젝트 멤버는 조직 reader와 유사합니다. 각 사용자 역할에 어떤 권한이 수반되는지에 대한 더 자세한 설명은 아래 표를 참조하세요.

조직에서 Owner가 아니라면 무엇에 액세스할 수 있나요?

조직에서 Owner가 아닌 사용자는 자신이 멤버인 프로젝트만 볼 수 있습니다. 조직 소유자만 프로젝트 수준의 모든 프로젝트, 멤버, API 키를 볼 수 있으며 Projects 페이지에 액세스할 수 있습니다.

• 프로젝트의 멤버(및 조직 소유자)만 해당 프로젝트 내에서 생성된 파인튜닝 모델, 생성된 Assistants의 스레드, 또는 추가된 파일을 볼 수 있습니다.

• 프로젝트 멤버는 해당 프로젝트의 다른 모든 멤버와 그 역할(즉, Owner 또는 Member)을 볼 수 있습니다.

사용자의 프로젝트 역할을 업데이트하거나 프로젝트에서 사용자를 제거하려면 어떻게 하나요?

프로젝트의 소유자만 사용자의 프로젝트 역할을 업데이트하거나 프로젝트에서 사용자를 제거할 수 있습니다. 자세한 내용은 역할 및 권한을 참조하세요.

프로젝트에서 사용자를 업데이트하려면 조직 설정으로 이동하여 프로젝트를 선택한 다음 Members를 클릭하세요. 각 멤버의 역할을 Member 또는 Owner. 로 설정할 수 있습니다. Remove를 선택하여 사용자를 프로젝트에서 제거할 수도 있습니다.

서비스 계정이란 무엇이며, 일반 사용자 계정과 어떻게 다른가요?

서비스 계정은 개별 사용자 계정과 구별되는, 시스템 액세스를 위해 설계된 의사 사용자 역할을 합니다. 조직 소유자와 프로젝트 소유자만 서비스 계정을 만들 수 있습니다.

프로젝트에 멤버 추가하기

+ Add member 버튼을 클릭하면 조직 내에서 Reader 역할을 가진 사용자 목록이 표시됩니다. 현재 조직에 속해 있지 않은 사용자를 추가하려면 먼저 해당 사용자를 조직에 추가해야 합니다(이 사용자들에게 더 넓은 액세스 권한을 주고 싶지 않다면 'Add to Default Project" 체크박스는 선택하지 않은 상태로 둘 수 있습니다). 이 목록에는 서비스 계정이 포함되지 않습니다. 이 단계에서 역할을 Owner 또는 Member로 선택할 수 있습니다:

팀 멤버를 추가할 때는 반드시 Member 또는 Owner 역할을 할당해야 합니다. 프로젝트 멤버는 데이터를 읽거나 수정하는 API 요청을 보낼 수 있으며, 프로젝트 소유자는 프로젝트 설정과 프로젝트 예산을 수정하고 프로젝트 멤버를 관리할 수도 있습니다. 자세한 내용은 역할 및 권한을 참조하세요.

프로젝트용 서비스 계정을 만드는 방법

먼저 탐색 막대의 드롭다운에서 선택하여 서비스 계정을 만들고자 하는 프로젝트로 이동하세요:

그런 다음 조직 설정 -> Project -> Members로 이동한 후 + Service account를 클릭하세요:

서비스 계정 이름 지정

조직 수준에서 서비스 계정을 만들든 프로젝트 전용 계정을 만들든, 서비스 계정을 만들 때는 문자, 숫자, 하이픈으로 구성된 고유한 서비스 계정 ID를 생성하여 서비스 계정을 쉽게 식별할 수 있습니다.

서비스 계정 API 키 저장

Create 버튼을 선택하면 서비스 계정의 API 키가 즉시 생성되고 시크릿 키가 표시됩니다. 이 시크릿 키는 안전한 곳에 저장하세요. 보안상의 이유로 OpenAI 계정을 통해 다시 볼 수 없습니다. 이 시크릿 키를 잃어버리면 새로 생성해야 합니다.

서비스 계정 API 키 권한은 기본적으로 프로젝트의 모든 API 리소스에 대한 읽기 및 쓰기로 설정됩니다. 이러한 권한은 프로젝트의 API Keys 설정에서 업데이트할 수 있습니다.

서비스 계정은 프로젝트의 멤버 설정 페이지에서 프로젝트 멤버와 함께 나열됩니다. 프로젝트의 멤버 설정 페이지에서 서비스 계정의 액세스를 업데이트하거나 제거하는 방법에 대해 자세히 알아보려면 여기를 참조하세요.

서비스 계정은 일반 계정처럼 관리됩니다. Organization -> Members 메뉴에서 서비스 계정을 Remove하거나 역할을 업데이트할 수 있습니다:

조직 프로젝트 내에서 API 키를 관리하려면 어떻게 하나요?

각 프로젝트의 설정 페이지에서 해당 프로젝트의 API 키를 생성하고 관리할 수 있습니다. 조직 설정에서 프로젝트를 선택한 다음 API Keys를 클릭하세요.

새 시크릿 키를 만들려면 + Create new secret key를 선택하세요. 시크릿 키 옆의 Edit 아이콘을 선택해 권한을 편집할 수도 있습니다.

새 시크릿 키를 만들 때 또는 기존 키를 편집할 때 각 API 키의 권한을 설정할 수 있습니다.

세 가지 권한 수준이 제공됩니다: All, Restricted, Read Only.

• All — 시크릿 키에 전체 권한이 설정됩니다. 기본 설정입니다.

• Restricted — 각 엔드포인트에 대해 None, Read, Write 권한을 설정할 수 있습니다.

  • 예를 들어, /v1/assistants 엔드포인트에 대해 Read 또는 Write 권한이 없는 API 키를 만들 수 있습니다:

    

• Read Only — 모든 엔드포인트에 읽기 권한이 설정됩니다.

여러 프로젝트 또는 조직에 속한 사용자의 액세스는 어떻게 관리되나요?

사용자는 필요한 만큼 많은 프로젝트의 멤버가 될 수 있습니다. 프로젝트 내에서 사용자는 해당 프로젝트와 그 리소스에 대한 액세스로 범위가 제한된 개인 API 키를 생성할 수 있습니다.

조직 프로젝트의 rate limit를 설정하고 관리하려면 어떻게 하나요?

조직의 소유자만 프로젝트 수준 rate limit를 설정하고 관리할 수 있습니다. 자세한 내용은 역할 및 권한을 참조하세요.


조직 설정에서 업데이트할 프로젝트를 클릭하고 탐색 목록의 Project 섹션에서 Limits를 선택하세요. 이 페이지에서 Model Usage를 업데이트할 수 있습니다.


Model usage를 통해 프로젝트에서 사용할 수 있는 모델을 구성할 수 있으며, 필요에 따라 각 모델에 대한 rate limit를 설정할 수 있습니다.

조직 프로젝트의 예산을 설정하고 관리하려면 어떻게 하나요?

조직의 소유자와 프로젝트의 소유자만 프로젝트 예산을 설정하고 관리할 수 있습니다. 자세한 내용은 역할 및 권한을 참조하세요. 조직 수준 제한을 변경하려면 조직 설정에서 Limits, 를 클릭한 다음 아래로 스크롤하여 Usage limits.로 이동하세요.

프로젝트 제한을 설정하려면 조직 설정에서 업데이트할 프로젝트를 클릭하고 Limits.를 선택하세요. Monthly budget, Notification threshold, Model Usage를 업데이트할 수 있습니다.


월간 예산을 설정하면 프로젝트에 대한 소프트 지출 임계값을 지정할 수 있습니다. 특정 달력 월(UTC) 내에 사용량이 이 한도를 초과해도 API 요청은 중단 없이 계속 처리됩니다. 이 기능은 예산 알림을 통해 사용량을 모니터링하도록 돕기 위한 것이며, 지출에 대한 하드 캡을 강제하지는 않습니다. 프로젝트 예산이 생성되면 기본적으로 100% 임계값에서 알림이 생성됩니다. 다른 임계값의 추가 예산은 Add Alert를 클릭하여 설정할 수 있습니다.

조직 소유자와 프로젝트 소유자는 항상 이러한 메시지를 수신하며, 이는 사용자 지정할 수 없습니다.

프로젝트를 삭제하거나 보관하려면 어떻게 하나요?

프로젝트는 새 프로젝트 목록 페이지 또는 개별 프로젝트의 설정에서 보관할 수 있습니다. 프로젝트가 보관되면 복원할 수 없습니다. 보관을 진행하면 계속하려면 프로젝트 이름을 입력하라는 메시지가 표시됩니다.

보관된 모든 프로젝트 목록은 동일한 프로젝트 목록 페이지의 “Archived” 탭에서 확인할 수 있습니다.

프로젝트 삭제는 불가능합니다. 사용량 및 청구 추적의 연속성을 보장하기 위해 모든 프로젝트의 기록을 유지합니다.

조직에서 가질 수 있는 프로젝트 수에 제한이 있나요?

조직은 기본적으로 최대 2,000개의 프로젝트를 만들 수 있습니다.

리소스를 프로젝트 간에 공유할 수 있나요?

프로젝트 리소스(예: 파일, 어시스턴트, 저장소 또는 스레드)는 해당 프로젝트 범위로 제한되며 프로젝트 외부의 비관리자 멤버는 액세스할 수 없습니다. 또한 리소스는 프로젝트 간에 이동할 수 없습니다.

프로젝트당 파일 저장소 할당량은 얼마인가요?

현재 OpenAI는 프로젝트당 최대 100GB의 파일 저장소 할당량을 지원합니다.

이 할당량을 초과하면 다음 오류가 표시됩니다:

계정에 저장된 사용하지 않는 파일을 삭제하는 것을 권장합니다. 참고로 API를 사용해 파일을 보고 나열할 수 있습니다.

프로젝트 소유자인데 왜 내 프로젝트의 사용량 대시보드가 보이지 않나요?

프로젝트의 사용량 대시보드 표시 여부는 프로젝트 내 사용자의 역할과 관련이 없습니다. 대신 조직 내 역할과 https://platform.openai.com/settings/organization/data-controls/visibility의 설정에 따라 결정됩니다.

사용량 대시보드가 보이지 않는다면 이 설정이 “조직 소유자에게 표시”로 설정되어 있을 가능성이 높습니다.