OpenAI

OpenAI API Platform 비용·사용량 + ChatGPT Workspace 활동·인증 이벤트를 통합 관리하기 위한 연동 가이드

OpenAI API Platform과 ChatGPT Workspace를 심플리에 연동하여 조직의 API 비용·토큰 사용량은 물론, ChatGPT 사용량·Codex 활동·로그인 이벤트까지 한 곳에서 관리할 수 있습니다.

주요 기능

기능	설명
조직 관리	멤버, 프로젝트, 초대 현황 조회
비용 추적	프로젝트별, 모델별 API 사용 비용 분석 (USD)
토큰 사용량	모델별 입력/출력 토큰 및 요청 수 현황
ChatGPT 사용량	ChatGPT Enterprise/Edu 워크스페이스의 대화·메시지 활동
Codex 활동	Codex 세션 수, 코드 변경량 등 개발자 생산성 지표
인증 이벤트	워크스페이스 로그인·SSO 이벤트

사전 요구사항

연동을 시작하기 전에 다음 조건을 확인하세요.

요구사항	설명
OpenAI 조직 계정	OpenAI Platform에 조직이 등록되어 있어야 합니다
Admin 또는 Owner 권한	API Platform 조직의 Admin 또는 Owner 권한이 필요합니다
ChatGPT Enterprise/Edu	ChatGPT Workspace 연동은 Enterprise 또는 Edu 플랜에서만 가능합니다 (선택)
ChatGPT Workspace ID	ChatGPT Workspace 연동 시 필요합니다. `chatgpt.com/admin`에서 확인하는 Enterprise Workspace ID로, Compliance API Key와 함께 입력합니다 (선택)
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 발급
1. OpenAI Platform에 로그인합니다.
2. 좌측 메뉴에서 Settings → Organization → Admin keys로 이동합니다.
3. Create admin key 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키(sk-admin-...)를 안전한 곳에 복사해 둡니다.
심플리에서 연동하기
1. 심플리에 로그인한 후, 설정 → 연동 페이지로 이동합니다.
2. AI 섹션에서 OpenAI 카드를 찾고, 연동하기 버튼을 클릭합니다.
3. API Platform (Admin) 섹션에 복사해 둔 Admin API Key를 입력합니다.
4. 연동하기 버튼을 클릭하면 즉시 조직·멤버·프로젝트 정보가 동기화됩니다.
5. 비용·사용량 데이터는 AI → OpenAI 메뉴에서 확인할 수 있습니다.

2. ChatGPT Workspace (Compliance) 연동

Compliance API Key와 Workspace ID 확인
1. ChatGPT Workspace 관리자 페이지에 로그인합니다.
2. Settings → Compliance → API Key로 이동합니다.
3. Create API Key 버튼을 클릭하여 새 키를 생성하고, 생성된 키를 안전한 곳에 복사해 둡니다.
4. 같은 관리자 페이지(chatgpt.com/admin)에서 Workspace ID를 확인해 함께 복사해 둡니다. Compliance 연동에는 API Key와 Workspace ID가 모두 필요합니다.
심플리에서 연동하기
1. 심플리 설정 → 연동 → OpenAI 페이지의 ChatGPT Workspace (Compliance) 섹션을 엽니다.
2. 복사해 둔 Compliance API Key와 Workspace ID를 각각 입력합니다.
3. 연동하기 버튼을 클릭하면 ChatGPT 사용량·Codex 활동·인증 이벤트가 동기화됩니다.

문제 해결

연동이 실패합니다

원인 1: 잘못된 키 형식

Admin API Key는 sk-admin-으로 시작해야 합니다. 일반 API Key(sk-proj-..., sk-...)나 Service Account Key를 입력하지 않았는지 확인하세요.
Compliance API Key는 ChatGPT Enterprise/Edu 워크스페이스에서 발급한 키여야 합니다. API Platform에서 발급한 키와 다릅니다.

원인 2: Workspace ID 누락 또는 오입력

Compliance 연동은 API Key와 함께 Workspace ID가 모두 입력되어야 합니다. chatgpt.com/admin에서 확인한 Workspace ID를 정확히 입력했는지 확인하세요.

원인 3: 권한 부족

OpenAI Platform에서 본인 계정의 역할이 Admin 또는 Owner인지 확인하세요. Reader 권한으로는 Admin Key를 발급할 수 없습니다.
ChatGPT Workspace에서는 Owner 또는 Workspace Admin 권한이 필요합니다.

원인 4: 자격증명 만료

OpenAI 측에서 키를 회수하거나 만료시킨 경우 연동 상태가 자격증명 오류로 표시됩니다. 새 키를 발급받아 다시 연동하세요.

비용/사용량 데이터가 보이지 않습니다

원인: 동기화 지연

조직·멤버·프로젝트 정보는 연동 직후 바로 동기화됩니다.
비용 및 사용량 데이터는 매일 오전 5시(KST)에 자동으로 동기화됩니다. 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: 연동 후 데이터가 바로 보이나요?

연동 직후 조직 정보(멤버, 프로젝트)는 바로 동기화됩니다. 비용 및 사용량 데이터는 매일 오전 5시(KST) 자동 배치로 동기화되며, 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) 연동만 가능합니다.