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

개요

프로젝트를 사용하면 API 조직 내의 작업을 체계적으로 정리할 수 있습니다. 프로젝트를 통해 모델, 기능, 스레드, 어시스턴트, 파인 튜닝, 스토리지 등 정해진 리소스 집합에 대한 액세스를 관리하고, 모델 및 요청 한도를 설정하고, 서비스 계정을 만들고, 사용량, 청구 내역, 지출 한도를 추적할 수 있습니다.

조직 소유자는 프로젝트 페이지에서 모든 활성 프로젝트와 보관된 프로젝트를 볼 수 있습니다.

시작하기 전에

프로젝트를 만들려면 조직 소유자 역할이 필요합니다. 조직은 기본적으로 최대 2,000개의 프로젝트를 만들 수 있습니다.

조직에서 통합 청구를 사용하는 경우 하위 조직은 조직 선택 메뉴에 별도로 표시됩니다. 하위 조직 내에서는 프로젝트를 만들 수 없습니다.

조직을 전환하려면 조직 선택 메뉴를 열고 사용할 조직을 선택하세요.

기본 프로젝트

모든 조직에는 삭제할 수 없는 기본 프로젝트가 포함되어 있습니다. 기본 프로젝트는 조직의 전체 설정을 상속합니다. 기본 프로젝트의 요청 한도, 가상 모델 권한, 지출 한도를 설정할 수 있습니다.

기본 프로젝트에는 멤버나 서비스 계정을 직접 추가할 수 없습니다. 이 문서의 조직 초대 절차에 따라 사용자를 조직에 초대할 때 기본 프로젝트에 대한 액세스 권한도 부여할 수 있습니다.

프로젝트 만들기

1. 프로젝트 선택 메뉴를 열고 프로젝트 만들기를 선택합니다.

2. 프로젝트의 이름, 설명, 웹사이트를 입력합니다.

3. 만들기를 선택합니다.

조직 소유자는 새 프로젝트에 소유자로 자동 추가됩니다.

역할 및 액세스 이해하기

아래 표는 이 안내에서 사용하는 조직 소유자 및 읽기 사용자 역할과 프로젝트 소유자 및 멤버 역할을 요약한 것입니다. 프로젝트 멤버는 조직 읽기 사용자와 유사한 권한을 갖습니다.

조직 역할에 대한 자세한 내용은 조직 역할을 참고하세요. 추가 역할, 맞춤 역할, 전체 권한에 대해서는 API 역할 및 권한 가이드를 참고하세요.

프로젝트 공개 범위

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

프로젝트 멤버는 같은 프로젝트의 다른 멤버와 각 멤버의 역할을 볼 수 있습니다. 해당 프로젝트 내에서 생성되거나 추가된 파인 튜닝된 모델, 어시스턴트 스레드, 파일은 프로젝트 멤버와 조직 소유자만 볼 수 있습니다.

필요한 만큼 여러 프로젝트에 참여할 수 있습니다. 프로젝트 내에서 만든 개인 API 키의 사용 범위는 해당 프로젝트와 그 리소스로 제한됩니다.

리소스 사용 범위

파일, 어시스턴트, 스토리지, 스레드의 사용 범위는 해당 프로젝트로 제한됩니다. 해당 프로젝트에 속하지 않은 멤버는 관리자가 아닌 한 프로젝트 리소스에 액세스할 수 없으며, 리소스를 프로젝트 간에 이동할 수도 없습니다.

예외적으로 기본 프로젝트의 파인 튜닝된 모델은 다른 프로젝트에서도 액세스할 수 있습니다.

프로젝트 멤버 관리하기

조직에 사용자 초대하기

조직에 사용자를 초대할 때 초대 양식에서 해당 옵션을 선택하면 기본 프로젝트에 대한 액세스 권한도 부여할 수 있습니다. 기본 프로젝트에 대한 액세스 권한을 부여하지 않으려면 이 옵션을 선택하지 마세요. 새 조직 멤버는 기본 프로젝트에 자동으로 추가되지 않습니다.

사용자를 초대하기 전에 별도의 프로젝트를 만들 필요는 없습니다. 사용자가 조직 초대를 수락한 후에 프로젝트에 추가할 수도 있습니다.

Admin API를 통해 보내는 초대에는 /organization/invites 엔드포인트의 규칙이 적용됩니다.

프로젝트에 조직 멤버 추가하기

조직 및 프로젝트 소유자는 다음과 같이 멤버를 추가할 수 있습니다.

1. 조직 설정으로 이동합니다.

2. 프로젝트를 선택한 다음 멤버를 엽니다.

3. 멤버 + 추가를 선택합니다.

4. 사용자를 선택하고 멤버 또는 소유자 역할을 부여합니다.

사용자 목록에는 읽기 사용자 역할이 있는 조직 사용자가 표시됩니다. 서비스 계정은 포함되지 않습니다.

UI 또는 Admin API에서 초대에 실패하면 초대를 다시 보내기 전에 대상 프로젝트가 존재하며 보관된 상태가 아닌지 확인하세요.

역할 변경 또는 멤버 제거하기

조직 및 프로젝트 소유자는 사용자의 프로젝트 역할을 변경하거나 해당 프로젝트에서 사용자를 제거할 수 있습니다.

1. 조직 설정으로 이동합니다.

2. 프로젝트를 선택한 다음 멤버를 엽니다.

3. 사용자의 역할을 멤버 또는 소유자로 설정하거나, 사용자를 제거하려면 제거를 선택합니다.

서비스 계정 만들기 및 관리하기

서비스 계정은 개별 사용자를 나타내는 계정이 아니라 시스템이 액세스하는 데 사용하는 계정입니다. 서비스 계정의 사용 범위는 프로젝트로 제한됩니다.

서비스 계정을 만들려면 서비스 계정 관리 권한이 필요합니다. 조직 및 프로젝트 소유자에게는 이 권한이 있습니다.

서비스 계정 만들기

1. 프로젝트 선택 메뉴에서 프로젝트를 선택합니다.

2. 조직 설정으로 이동하여 프로젝트를 선택합니다.

3. 멤버를 열고 + 서비스 계정을 선택합니다.

4. 영문자, 숫자, 하이픈을 사용하여 고유한 서비스 계정 ID를 입력합니다.

5. 만들기를 선택합니다.

조직 수준 설정에서 만들든 프로젝트 수준 설정에서 만들든 서비스 계정에는 동일한 ID 형식이 적용됩니다.

프로젝트용으로 만든 서비스 계정은 해당 프로젝트 전용이며 프로젝트 외부에서는 사용할 수 없습니다.

비밀 키 저장하기

서비스 계정을 만들면 즉시 API 키가 생성되고 비밀 키가 표시됩니다. 비밀 키를 안전하게 저장하세요. OpenAI 계정에서 이 키를 다시 확인할 수는 없습니다. 키를 분실한 경우 새 키를 생성하세요.

기본적으로 서비스 계정 키는 해당 프로젝트의 모든 API 리소스를 읽고 쓸 수 있습니다. 이러한 권한은 나중에 프로젝트의 API 키 설정에서 변경할 수 있습니다.

서비스 계정은 프로젝트의 멤버 설정에 사용자와 함께 표시됩니다. 다른 프로젝트 멤버와 동일한 역할 변경 및 제거 절차를 사용하여 서비스 계정의 프로젝트 액세스를 관리하세요.

조직 수준 및 프로젝트 수준 설정에서 만든 계정을 포함한 모든 서비스 계정은 조직의 멤버 페이지에도 사용자와 함께 표시됩니다.

조직의 멤버 메뉴에서 서비스 계정의 역할을 변경하거나 제거를 선택할 수 있습니다.

API 키 만들기 및 관리하기

각 프로젝트에는 자체 API 키가 있습니다.

1. 조직 설정으로 이동합니다.

2. 프로젝트를 선택한 다음 API 키를 엽니다.

3. 키를 만들려면 + 새 비밀 키 만들기를 선택하고, 기존 키의 권한을 변경하려면 해당 키 옆의 편집 아이콘을 선택합니다.

키 권한 선택하기

사용자 소유 키는 생성 시 권한을 설정하거나 나중에 수정할 수 있습니다.

• 전체: 모든 권한을 부여합니다. 기본 설정입니다.

• 제한됨: 특정 리소스 또는 엔드포인트의 권한 범위를 선택합니다. 사용 가능한 옵션은 리소스에 따라 다르며, 없음, 읽기, 쓰기 또는 요청별 권한이 포함될 수 있습니다.

• 읽기 전용: 모든 엔드포인트에 대한 읽기 권한을 부여합니다.

예를 들어 제한된 키에서는 /v1/assistants 엔드포인트에 대한 읽기 및 쓰기 액세스를 제외할 수 있습니다.

서비스 계정 키를 만들려면 서비스 계정 관리 권한이 필요합니다. 해당 옵션이 보이지 않으면 조직 또는 프로젝트 소유자에게 서비스 계정 키 생성을 요청하세요. 서비스 계정 키의 경우 키 생성 대화 상자에 이러한 권한 설정 항목이 표시되지 않습니다. 생성 후 프로젝트의 API 키 설정에서 권한을 변경하세요.

모델 액세스 및 요청 한도 설정하기

프로젝트 요청 한도를 관리하려면 관리자 권한이 필요합니다. 조직 소유자에게는 이 권한이 있으며, 프로젝트 소유자도 관리 API를 통해 프로젝트 요청 한도를 관리할 수 있습니다.

1. 조직 설정으로 이동합니다.

2. 프로젝트를 선택한 다음 한도를 엽니다.

3. 모델 사용에서 프로젝트가 사용할 수 있는 모델을 선택합니다.

4. 필요에 따라 각 모델의 요청 한도를 설정합니다.

지출 한도 및 알림 설정하기

조직 수준과 프로젝트 수준 모두에서 월별 API 지출 한도를 설정할 수 있습니다. 한도를 변경하려면 해당 조직 또는 프로젝트의 설정을 관리할 권한이 필요합니다.

지출 한도를 사용하면 요청을 중단하지 않고도 지출을 모니터링할 수 있습니다. 집계된 지출이 한도에 도달하면 API 요청이 실패하도록 하려면 엄격한 지출 한도 적용을 켜세요. 한도 적용은 즉시 이루어지지 않으므로 기록된 지출이 설정 금액을 약간 초과할 수 있습니다.

지출 알림은 지정된 기준에 도달하면 알려 주지만 요청을 중단하지는 않습니다.

조직 지출 한도 설정하기

1. 조직 설정으로 이동합니다.

2. 한도를 열고 지출을 찾습니다.

프로젝트 지출 한도 설정하기

1. 조직 설정으로 이동합니다.

2. 프로젝트를 선택한 다음 한도를 엽니다.

3. 월별 지출 한도 및 지출 도달 시 알림 값을 설정합니다.

4. 집계된 지출이 한도에 도달하면 API 트래픽을 중단하려면 엄격한 지출 한도 적용을 켭니다.

이 페이지에서 모델 사용 설정도 변경할 수 있습니다.

지출 알림 관리하기

프로젝트 지출 한도를 설정하면 기본적으로 한도의 100%에 도달했을 때 보내는 알림도 생성됩니다. 다른 기준에 대한 알림을 추가하려면 알림 추가를 선택합니다.

조직 및 프로젝트 소유자는 프로젝트 지출 알림을 받습니다. 알림 설정에서 다른 이메일 수신자를 추가할 수 있습니다.

최신 설정 절차와 한도 적용 방식은 지출 한도 가이드를 참고하세요.

사용량 및 청구 내역 보기

사용 내역을 프로젝트별로 나누어 확인하고, 개별 프로젝트의 청구 내역을 조회하거나 지출 한도를 설정할 수 있습니다.

프로젝트의 사용량 대시보드에 액세스할 수 있는지는 조직 내 역할과 사용량 대시보드 공개 범위 설정에 따라 달라집니다. 프로젝트 소유자라는 이유만으로 액세스 권한이 부여되지는 않습니다.

프로젝트의 사용량 대시보드가 보이지 않으면 공개 범위가 조직 소유자에게 공개로 설정되어 있는지 확인하세요.

파일 스토리지 관리하기

각 프로젝트의 파일 스토리지 할당량은 100GB입니다. 할당량을 초과하면 다음 오류가 표시될 수 있습니다.

파일 스토리지 할당량을 초과했습니다. 조직별 파일 용량은 100GB로 제한됩니다. 파일 크기를 줄이거나 지원팀에 문의하세요.

사용하지 않는 파일을 삭제하여 저장 공간을 확보하세요. API를 통해 저장된 파일 목록을 조회하여 더 이상 필요하지 않은 파일을 확인할 수 있습니다.

프로젝트 보관하기

조직 및 프로젝트 소유자는 프로젝트 페이지 또는 개별 프로젝트의 설정에서 프로젝트를 보관할 수 있습니다. 확인 메시지가 표시되면 프로젝트 이름을 입력합니다.

보관은 영구적으로 적용되며, 보관된 프로젝트는 복원할 수 없습니다.

보관된 프로젝트를 보려면 프로젝트 페이지에서 보관됨 탭을 여세요.

프로젝트는 삭제할 수 없습니다. OpenAI는 사용량 및 청구 내역을 추적하기 위해 프로젝트 기록을 유지합니다.