💎 OpenAI API 사용 - platform.openai.com
OpenAI API 플랫폼 메뉴 안내서
1. 상위 메뉴
1.1 Home --- 시작 화면
프로젝트의 주요 기능으로 이동하는 출발점입니다. API 개발 관련 안내나 주요 작업으로 연결되는 화면입니다.
활용도: 필요할 때 이용
1.2 Chat --- 대화형 AI 테스트
웹 화면에서 AI와 대화하며 모델의 답변을 시험할 수 있습니다. PHP 코드를 수정하지 않고 프롬프트, 문체, 결과의 품질을 살펴보는 용도로 활용할 수 있습니다.
활용 예: 가정통신문에 사용할 키워드를 입력해 문장이 얼마나 자연스럽게 생성되는지 확인합니다.
활용도: 높음 --- 프롬프트와 출력 품질을 시험할 때 유용
1.3 Decisions --- 의사결정 관련 기능
의사결정에 특화된 기능을 제공하는 메뉴입니다. 메뉴 이름만으로 정확한 세부 동작을 단정하기는 어렵습니다. 일반적인 텍스트 생성 API를 호출하는 기능에는 우선 필요하지 않습니다.
활용도: 현재는 낮음
1.4 Agents --- AI 에이전트
AI가 지시를 따르고 여러 단계의 작업을 수행하도록 구성하는 기능과 관련됩니다. 단순히 키워드를 받아 짧은 안내문을 생성하는 기능에는 필수적이지 않습니다.
향후 활용 예: 자료 검색, 여러 단계의 처리, 다른 도구와의 연계가 필요한 기능을 개발할 때 검토할 수 있습니다.
활용도: 현재는 낮음
1.5 Audio --- 음성 AI
음성을 문자로 변환하거나, 문자를 음성으로 읽어 주거나, 음성을 처리하는 기능과 관련됩니다.
향후 활용 예: 생성한 가정통신문을 음성으로 읽어 주는 기능
활용도: 음성 기능을 추가할 경우 검토
1.6 Images --- 이미지 생성·처리
이미지 생성 및 이미지 관련 AI 기능을 이용하는 메뉴입니다.
향후 활용 예: 안내문에 들어갈 삽화나 학습 자료 이미지를 자동으로 생성하는 기능
이미지 기능은 일반 텍스트 생성과 별도의 비용이 발생할 수 있으므로, 도입 전 가격과 사용 조건을 확인합니다.
활용도: 이미지 기능을 추가할 경우 검토
1.7 Codex --- AI 코딩 도우미
코드를 작성하고 검토하거나 수정하는 작업을 돕는 AI 코딩 도구입니다. PHP 코드 분석이나 오류 수정에 도움을 받을 수 있지만, 현재 PHP 프로그램에서 API를 호출하는 기능과는 별개의 개발 도구입니다.
활용도: 개발·코드 검토에 필요할 때
1.8 API Keys --- API 인증 키
PHP 서버가 OpenAI API를 호출할 때 사용하는 비밀 키를 생성하고 관리합니다.
- 키를 생성하거나 사용하지 않는 키를 폐기할 수 있습니다.
- 키가 외부에 노출되면 다른 사람이 API를 호출해 비용을 발생시킬 수 있습니다.
- API 키는 PHP 서버에만 보관합니다.
- HTML이나 브라우저 JavaScript, 공개 저장소, 화면 출력 등에 API 키를 노출하지 않습니다.
- 키가 노출되었다고 의심되면 해당 키를 폐기하고 새 키를 발급합니다.
활용도: 매우 높음 --- 보안상 중요
1.9 Usage --- 사용량 및 비용 확인
API 사용량과 비용을 확인하는 메뉴입니다.
- 기간별 API 사용량과 비용 확인
- 프로젝트별 사용량 비교(화면에서 지원되는 경우)
- 사용 내역 및 관련 데이터 확인
- 사용량이 예상보다 빠르게 증가하는지 점검
하루 수백~수천 건의 요청이 발생한다면, 실제 비용이 예상 범위에 있는지 주기적으로 확인하는 것이 좋습니다. 대시보드의 시간 기준이 UTC일 수 있으므로 한국 시간과 비교할 때는 시간대에 주의합니다.
활용도: 매우 높음 --- 운영비 관리의 핵심 메뉴
1.10 Logs --- 로그 및 기록
API 관련 기록이나 작업 실행 정보를 살펴보는 메뉴입니다. 오류가 발생했을 때 관련 요청이나 처리 기록을 확인하는 데 도움이 될 수 있습니다. 구체적으로 조회할 수 있는 기록의 범위는 현재 화면과 계정에서 제공되는 기능에 따라 달라집니다.
활용도: 오류 분석이 필요할 때
1.11 Batches --- 일괄 처리
여러 API 요청을 묶어 비동기 방식으로 처리하는 기능입니다. 사용자가 버튼을 누를 때마다 즉시 안내문을 생성하는 방식보다는, 많은 자료를 한꺼번에 생성하거나 분석하는 작업에 적합할 수 있습니다.
활용 예: 수백 개의 자료를 한 번에 생성하는 작업
활용도: 대량 작업이 필요할 때
1.12 Storage --- 저장 공간
API 기능에서 사용하는 파일이나 관련 자료를 저장하고 관리하는 기능과 관련됩니다. 파일을 업로드해 처리하거나 일괄 작업에 필요한 자료를 보관할 때 사용할 수 있습니다.
현재처럼 텍스트를 직접 API에 보내고 결과를 받는 구조라면 당장 필요하지 않을 수 있습니다.
활용도: 파일 처리 기능을 도입할 때
1.13 Plugins --- 플러그인
외부 도구나 추가 기능을 연결해 활용하는 영역입니다. 구체적으로 제공되는 기능은 현재 플랫폼 구성과 계정에 따라 달라질 수 있습니다. PHP에서 OpenAI API를 직접 호출하는 데 반드시 필요한 메뉴는 아닙니다.
활용도: 추가 연동 기능이 필요할 때
1.14 Settings --- 설정
프로젝트와 계정의 운영 설정을 관리하는 메뉴입니다. 프로젝트 정보, API 키, 구성원, 결제, 사용 한도, 데이터 관리, 보안 등을 설정할 수 있습니다.
세부 항목은 아래의 2. Settings 하위 메뉴를 참고합니다.
활용도: 높음 --- 초기 설정과 운영 관리에 필요
1.15 More --- 추가 메뉴
현재 왼쪽 메뉴에 직접 표시되지 않은 기능으로 이동하는 항목입니다. 클릭했을 때 표시되는 목록을 통해 추가 기능을 확인할 수 있습니다.
활용도: 필요할 때 확인
2. Settings 하위 메뉴
2.1 General --- 일반 설정
프로젝트의 기본 정보와 일반 설정을 관리하는 영역입니다.
활용 예: 프로젝트 이름 등 기본 정보 확인
활용도: 프로젝트를 처음 구성하거나 기본 정보를 바꿀 때
2.2 API keys --- API 키 관리
해당 프로젝트에서 사용할 API 키를 생성하고 관리합니다.
- 필요한 용도에 맞는 키를 발급합니다.
- 키를 안전하게 보관하고 사용하지 않는 키는 정리합니다.
- 개발용과 운영용 키를 분리하면 관리가 쉬워질 수 있습니다.
- API 키를 PHP 서버 외부에 노출하지 않습니다.
주의: API 키는 비밀번호처럼 취급합니다. 코드에 직접 넣어 공개 저장소에 올리거나 웹 페이지에 출력하지 않습니다.
활용도: 매우 높음
2.3 Admin keys --- 관리자 키
조직 관리 수준의 작업을 수행하기 위한 높은 권한의 키와 관련된 메뉴입니다. 일반적인 API 요청에 사용하는 프로젝트 API 키와는 목적이 다릅니다.
주의: 일반적인 PHP 텍스트 생성 기능에는 보통 필요하지 않습니다. 높은 권한의 키는 꼭 필요한 관리자 작업에만 사용하고 안전하게 관리해야 합니다.
활용도: 일반 개발에서는 낮음
2.4 People --- 구성원
프로젝트 또는 조직에 접근할 수 있는 사람과 권한을 관리하는 영역입니다.
활용 예: 여러 개발자가 함께 작업할 때 사용자별 접근 권한 관리
활용도: 공동 작업을 할 때
2.5 Projects --- 프로젝트 관리
프로젝트를 구분하고 각 프로젝트의 API 키, 사용량, 설정 등을 관리하는 영역입니다. 개발용과 운영용을 분리하면 테스트 사용량과 실제 서비스 사용량을 구분하기 쉬워집니다.
권장 방향: 테스트 환경과 실제 운영 환경을 구분할 필요가 생기면 프로젝트 분리를 검토합니다. 현재 구성은 실제 화면과 운영 방식에 맞춰 결정합니다.
활용도: 중간~높음
2.6 Billing --- 결제 및 잔액
API 사용료와 결제 수단, 충전 잔액, 결제 내역 등을 관리합니다.
현재 확인한 화면에는 다음과 같이 표시되어 있었습니다.
- 결제 방식: Pay as you go
- API credit balance: $9.99
- Auto-reload: OFF
- 잔액이 $0에 도달하면 API 요청이 중단될 수 있다는 안내
따라서 확인 당시에는 선불 크레딧 잔액을 사용하며, 자동 충전은 꺼져 있는 상태였습니다. 잔액이 소진되면 API 요청이 실패할 수 있으므로 서비스 운영 중에는 잔액을 주기적으로 확인합니다.
확인할 항목 - 현재 크레딧 잔액 - 결제 수단과 기본 결제 수단 - 충전 및 결제 내역 - 자동 충전 설정 여부
활용도: 매우 높음 --- 서비스 중단과 비용 관리에 중요
2.7 Limits --- 사용 한도
모델 접근 권한, 요청 속도 제한, 지출 관련 한도나 제한 조건을 확인하는 영역입니다. 실제 제공되는 항목은 계정과 프로젝트 설정에 따라 다를 수 있습니다.
확인할 항목 - 사용할 모델에 접근할 수 있는지 - 분당 요청 수나 토큰 처리량 등의 제한 - 지출 한도 또는 사용량 알림 설정 - 한도에 도달했을 때 요청이 차단되는지 여부
주의: 사용량 알림이나 예산 관련 설정이 모두 요청을 강제로 차단하는 것은 아닙니다. 알림용 설정과 실제 요청을 제한하는 한도는 구분해야 합니다. 설정 화면의 설명을 확인하고, 서비스가 한도에 도달했을 때 어떻게 동작하는지 점검합니다.
활용도: 매우 높음 --- 안정적인 운영을 위해 확인
2.8 Tunnels --- 터널 관련 기능
현재 화면에 표시된 메뉴 이름만으로는 이 계정에서 제공되는 구체적인 기능을 확정하기 어렵습니다. 일반적인 PHP 서버의 텍스트 생성 API 호출을 구성하는 데는 보통 우선적으로 확인할 필요가 없습니다.
활용도: 현재는 낮음 --- 필요가 생기면 해당 화면의 설명 확인
2.9 Usage --- 사용량 확인
API 사용량과 비용을 살펴보는 영역입니다. 상위 메뉴에도 Usage가 별도로 표시되어 있으므로, 실제 화면에 따라 같은 사용량 대시보드 또는 관련 기능으로 연결될 수 있습니다.
운영 시 확인할 사항 - 날짜별·기간별 비용 추이 - 실제 요청 수와 사용량 - 테스트 사용량과 운영 사용량의 차이 - 예상보다 비용이 급격히 늘어나는지 여부
가능하다면 PHP API 응답에 포함된 usage 정보를 서버 로그에 기록해 요청별 토큰 사용량을 분석할 수 있습니다. 이때 사용자 개인정보나 안내문 원문을 불필요하게 저장하지 않도록 주의합니다.
활용도: 매우 높음
2.10 Service health --- 서비스 상태
OpenAI 서비스 및 API의 장애나 서비스 상태를 확인하는 영역입니다. API 호출이 갑자기 실패할 때 내 코드의 문제인지, 서비스 측 장애인지 구분하는 데 도움이 될 수 있습니다.
활용도: 오류가 발생했을 때
2.11 Data controls --- 데이터 관리
데이터 처리, 보관 또는 공유와 관련된 설정을 확인하는 영역입니다. 정확한 선택 항목은 계정과 현재 제공되는 기능에 따라 달라질 수 있습니다.
유의 사항: 교사나 학생과 관련된 정보가 API 요청에 포함될 수 있다면, 어떤 데이터를 보내는지 최소화하고 개인정보 처리 원칙과 서비스 운영 정책을 함께 검토합니다.
활용도: 높음 --- 개인정보 및 데이터 관리 검토 시
2.12 Security --- 보안
계정 또는 조직의 보안과 접근 제어 관련 설정을 관리하는 영역입니다.
확인할 사항 - 계정 접근 보안 - 사용자와 권한 관리 - 제공되는 보안 옵션
API 키를 안전하게 관리하는 것과 함께 계정 보안도 점검하는 것이 좋습니다.
활용도: 높음
2.13 Webhooks --- 웹훅
지원되는 이벤트가 발생했을 때 지정한 주소로 알림이나 데이터를 전달하도록 구성하는 기능입니다. 모든 API 요청에 웹훅이 필요한 것은 아닙니다.
현재처럼 PHP가 API를 호출하고 응답을 즉시 받아 안내문을 보여 주는 구조라면 일반적으로 필수 기능은 아닙니다. 비동기 작업이나 특정 이벤트에 대한 후속 처리가 필요해질 때 검토할 수 있습니다.
활용도: 현재는 낮음
3. 검토 우선순위
우선순위 메뉴 확인할 목적
1 API Keys API 인증 키의 발급·보관·교체
2 Usage 실제 토큰 사용량과 비용 확인
3 Settings → Billing 크레딧 잔액, 결제 수단, 자동 충전 확인
4 Settings → Limits 요청 제한과 지출 관련 설정 확인
5 Settings → Projects 개발용과 운영용 환경의 구분 검토
6 Settings → Data 데이터 처리와 계정 보안 controls / Security 점검
7 Chat 프롬프트와 결과 품질 시험
8 Logs / Service health 오류 원인 분석
3.1 운영 전 점검 목록
- API 키가 PHP 서버에만 보관되어 있는가?
- API 키가 HTML, 브라우저 JavaScript, 공개 저장소에 노출되지 않는가?
- Usage에서 실제 사용량과 비용을 확인할 수 있는가?
- 크레딧 잔액과 자동 충전 상태를 확인했는가?
- Limits에서 요청 제한과 지출 관련 설정의 의미를 확인했는가?
- API 오류가 발생했을 때 사용자에게 적절한 안내를 표시하는가?
- 요청별 사용량을 기록하더라도 개인정보를 불필요하게 저장하지 않는가?
- 테스트 요청과 실제 서비스 요청의 비용을 구분해 점검할 수 있는가?
4. 핵심 정리
PHP에서 OpenAI API를 호출해 짧은 가정통신문을 생성하는 서비스라면, 처음부터 모든 메뉴를 사용할 필요는 없습니다.
우선 API Keys, Usage, Settings의 Billing과 Limits를 익히는 것이 중요합니다. API 키 보안, 실제 사용량 확인, 크레딧 잔액 관리, 요청 제한 점검을 꾸준히 하면 운영 중 발생할 수 있는 비용 문제와 서비스 중단 위험을 줄이는 데 도움이 됩니다.
메뉴 이름과 설명은 현재 확인한 화면을 기준으로 정리했으며, 세부 기능과 정책은 OpenAI 플랫폼의 업데이트에 따라 달라질 수 있습니다.