# OpenAI

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

## 주요 기능

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

{% hint style="info" %}
OpenAI 연동은 **두 종류의 API Key**를 사용합니다.\
**Admin API Key** (`sk-admin-...`) — API Platform의 비용·사용량 데이터용\
**Compliance API Key** — ChatGPT Enterprise/Edu의 활동·인증 이벤트용\
필요한 영역만 부분 연동하거나, 두 가지를 모두 연동할 수 있습니다.
{% endhint %}

***

#### 사전 요구사항

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

| 요구사항                       | 설명                                                       |
| -------------------------- | -------------------------------------------------------- |
| **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) 연동

{% stepper %}
{% step %}

#### Admin API Key 발급

1. [OpenAI Platform](https://platform.openai.com)에 로그인합니다.
2. 좌측 메뉴에서 **Settings → Organization → Admin keys**로 이동합니다.
3. **Create admin key** 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키(`sk-admin-...`)를 안전한 곳에 복사해 둡니다.
   {% endstep %}

{% step %}

#### 심플리에서 연동하기

1. 심플리에 로그인한 후, **설정 → 연동** 페이지로 이동합니다.
2. **AI** 섹션에서 **OpenAI** 카드를 찾고, **연동하기** 버튼을 클릭합니다.
3. **API Platform (Admin)** 섹션에 복사해 둔 Admin API Key를 입력합니다.
4. **연동하기** 버튼을 클릭하면 즉시 조직·멤버·프로젝트 정보가 동기화됩니다.
5. 비용·사용량 데이터는 **AI → OpenAI** 메뉴에서 확인할 수 있습니다.
   {% endstep %}
   {% endstepper %}

{% hint style="warning" %}
Admin API Key는 생성 직후에만 전체 값을 확인할 수 있습니다. 키를 분실한 경우 새로 발급받아야 합니다.
{% endhint %}

### 2. ChatGPT Workspace (Compliance) 연동

{% hint style="info" %}
**Compliance API**는 ChatGPT Enterprise 또는 Edu 플랜에서만 제공됩니다. 일반 ChatGPT Plus·Team 플랜에서는 사용할 수 없습니다.
{% endhint %}

{% stepper %}
{% step %}

#### Compliance API Key 발급

1. [ChatGPT Workspace 관리자 페이지](https://chatgpt.com)에 로그인합니다.
2. **Settings → Compliance → API Key**로 이동합니다.
3. **Create API Key** 버튼을 클릭하여 새 키를 생성합니다.
4. 생성된 키를 안전한 곳에 복사해 둡니다.
   {% endstep %}

{% step %}

#### 심플리에서 연동하기

1. 심플리 **설정 → 연동 → OpenAI** 페이지의 **ChatGPT Workspace (Compliance)** 섹션을 엽니다.
2. 복사해 둔 Compliance API Key를 입력합니다.
3. **연동하기** 버튼을 클릭하면 ChatGPT 사용량·Codex 활동·인증 이벤트가 동기화됩니다.
   {% endstep %}
   {% endstepper %}

***

#### 문제 해결

**연동이 실패합니다**

**원인 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) 연동만 가능합니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/saas-integration/guide-main/openai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.