OpenAI
OpenAI API Platform 비용·사용량 + ChatGPT Workspace 활동·인증 이벤트를 통합 관리하기 위한 연동 가이드
OpenAI API Platform과 ChatGPT Workspace를 심플리에 연동하여 조직의 API 비용·토큰 사용량은 물론, ChatGPT 사용량·Codex 활동·로그인 이벤트까지 한 곳에서 관리할 수 있습니다.
주요 기능
조직 관리
멤버, 프로젝트, 초대 현황 조회
비용 추적
프로젝트별, 모델별 API 사용 비용 분석 (USD)
토큰 사용량
모델별 입력/출력 토큰 및 요청 수 현황
ChatGPT 사용량
ChatGPT Enterprise/Edu 워크스페이스의 대화·메시지 활동
Codex 활동
Codex 세션 수, 코드 변경량 등 개발자 생산성 지표
인증 이벤트
워크스페이스 로그인·SSO 이벤트
OpenAI 연동은 두 종류의 API Key를 사용합니다.
Admin API Key (sk-admin-...) — API Platform의 비용·사용량 데이터용
Compliance API Key — ChatGPT Enterprise/Edu의 활동·인증 이벤트용
필요한 영역만 부분 연동하거나, 두 가지를 모두 연동할 수 있습니다.
사전 요구사항
연동을 시작하기 전에 다음 조건을 확인하세요.
OpenAI 조직 계정
OpenAI Platform에 조직이 등록되어 있어야 합니다
Admin 또는 Owner 권한
API Platform 조직의 Admin 또는 Owner 권한이 필요합니다
ChatGPT Enterprise/Edu
ChatGPT Workspace 연동은 Enterprise 또는 Edu 플랜에서만 가능합니다 (선택)
SMPLY 관리자
심플리에서 연동 설정 권한이 필요합니다
연동 범위
OpenAI 연동 시 다음 정보가 동기화됩니다.
Admin API Key
조직 정보, 멤버, 프로젝트, 비용(USD), 모델별 토큰 사용량
Compliance API Key
ChatGPT 메시지·대화 활동, Codex 세션·코드 변경, 로그인·SSO 이벤트
연동 방법
OpenAI 연동은 API Platform (Admin) 과 ChatGPT Workspace (Compliance) 두 섹션이 분리되어 있습니다. 필요한 섹션만 따로 연동할 수 있으며, 두 섹션을 모두 연동하면 비용과 사용 활동을 교차 분석할 수 있습니다.
1. API Platform (Admin) 연동
Admin API Key 발급
OpenAI Platform에 로그인합니다.
좌측 메뉴에서 Settings → Organization → Admin keys로 이동합니다.
Create admin key 버튼을 클릭하여 새 키를 생성합니다.
생성된 키(
sk-admin-...)를 안전한 곳에 복사해 둡니다.
Admin API Key는 생성 직후에만 전체 값을 확인할 수 있습니다. 키를 분실한 경우 새로 발급받아야 합니다.
2. ChatGPT Workspace (Compliance) 연동
Compliance API는 ChatGPT Enterprise 또는 Edu 플랜에서만 제공됩니다. 일반 ChatGPT Plus·Team 플랜에서는 사용할 수 없습니다.
Compliance API Key 발급
ChatGPT Workspace 관리자 페이지에 로그인합니다.
Settings → Compliance → API Key로 이동합니다.
Create API Key 버튼을 클릭하여 새 키를 생성합니다.
생성된 키를 안전한 곳에 복사해 둡니다.
문제 해결
연동이 실패합니다
원인 1: 잘못된 키 형식
Admin API Key는
sk-admin-으로 시작해야 합니다. 일반 API Key(sk-proj-...,sk-...)나 Service Account Key를 입력하지 않았는지 확인하세요.Compliance API Key는 ChatGPT Enterprise/Edu 워크스페이스에서 발급한 키여야 합니다. API Platform에서 발급한 키와 다릅니다.
원인 2: 권한 부족
OpenAI Platform에서 본인 계정의 역할이 Admin 또는 Owner인지 확인하세요. Reader 권한으로는 Admin Key를 발급할 수 없습니다.
ChatGPT Workspace에서는 Owner 또는 Workspace Admin 권한이 필요합니다.
원인 3: 자격증명 만료
OpenAI 측에서 키를 회수하거나 만료시킨 경우 연동 상태가 자격증명 오류로 표시됩니다. 새 키를 발급받아 다시 연동하세요.
비용/사용량 데이터가 보이지 않습니다
원인: 동기화 지연
조직·멤버·프로젝트 정보는 연동 직후 바로 동기화됩니다.
비용 및 사용량 데이터는 OpenAI API 제공 주기에 따라 최대 24시간이 소요될 수 있습니다.
ChatGPT Compliance 데이터는 별도 배치로 동기화되므로 첫 적재까지 다소 시간이 걸릴 수 있습니다.
자주 묻는 질문
Q: Admin API Key와 Compliance API Key를 모두 등록해야 하나요?
아니요. 필요한 영역만 등록할 수 있습니다. 비용·토큰만 보고 싶다면 Admin Key만, ChatGPT 사용 활동만 보고 싶다면 Compliance Key만 등록해도 됩니다. 두 키를 모두 등록하면 비용과 활동을 교차 분석할 수 있습니다.
Q: 일반 API Key (sk-proj-..., sk-...)로 연동할 수 있나요?
아니요. 심플리 연동에는 조직 관리용 Admin API Key (sk-admin-...)가 필요합니다. 일반 API Key는 모델 호출 권한만 있고 조직·비용 정보 조회 권한이 없어 연동에 사용할 수 없습니다.
Q: 연동 후 데이터가 바로 보이나요?
연동 직후 조직 정보(멤버, 프로젝트)는 바로 동기화됩니다. 비용 및 사용량 데이터는 OpenAI API 제공 주기에 따라 최대 24시간이 소요될 수 있습니다.
Q: API Key를 교체하고 싶어요.
기존 연동을 해제한 후, 새 API Key로 다시 연동하면 됩니다. Admin과 Compliance는 각각 독립적으로 해제·재연동할 수 있습니다.
Q: 연동을 해제하면 데이터가 삭제되나요?
연동을 해제해도 이미 수집된 데이터는 유지됩니다. 단, 더 이상 OpenAI와 동기화되지 않으며, 심플리에 저장된 API Key는 삭제됩니다.
Q: 여러 OpenAI 조직을 연동할 수 있나요?
하나의 SMPLY 워크스페이스에는 하나의 OpenAI 조직만 연동할 수 있습니다. 별도 조직이 있다면 각각 다른 SMPLY 워크스페이스에 연동해야 합니다.
Q: ChatGPT Plus·Team 플랜도 Compliance 연동이 되나요?
아니요. Compliance API는 ChatGPT Enterprise·Edu 플랜에서만 제공됩니다. Plus·Team 플랜은 API Platform (Admin) 연동만 가능합니다.
Last updated