계정 유형 · 개발 → 운영 전환
공공데이터포털의 개발계정(유형1)·운영계정(유형2)과 같은 방식으로, 연동 개발과 실서비스를 분리합니다. 플랫폼 이용 가이드는 공개 개발자 문서와 본 포털에서 제공합니다.
/docs·/guide)을 기준으로 합니다.
내부 운영 저장소의 런북·IP·키 절차는 공개하지 않습니다.
개요
Open AI Service Hub은 개발 단계와 운영(실서비스) 단계를 분리해 API 키·모델 접근·트래픽 한도를 다르게 적용합니다. 서비스를 만들 때는 개발계정으로 빠르게 연동하고, 오픈 전에는 운영계정으로 전환·심사를 받습니다.
| 구분 | 개발계정 (유형1) | 운영계정 (유형2) |
|---|---|---|
| 목적 | API 연동·프로토타입·내부 테스트 | 실서비스·대고객 트래픽 |
| 승인 | 자동 승인 (가입·신청 즉시) | 심의 승인 (운영자 검토, 영업일 2~3일) |
| API 키 | 신규 발급 sk-dev-* | 추가 발급 sk-ops-* (개발키 유지) |
| 모델 | 일부 모델 (경량·체험 위주) | 신청 시 선택 또는 전체 모델 |
| 트래픽 | 약 1만 건/일 | 약 10만 건/일 (협의 가능) |
| 과금 | 무료 (개발용) | 유료 구독 (도입 예정) |
회원 유형 vs 사용 등급
헷갈리기 쉬운 두 축을 구분합니다.
| 축 | 값 | 의미 |
|---|---|---|
| 회원 유형 가입 시 | 개인 · 법인 | 가입·로그인 시 수집하는 신원 정보. 법인은 회사명·사업자번호·담당자 정보를 추가로 받습니다. 법인 회원가입 |
| 사용 등급 도입 예정 | 개발 · 운영 | API 키 권한·모델·일일 한도를 결정합니다. 한 계정이 개발 → 운영으로 전환할 수 있습니다. |
개발계정 (유형1)
Open API로 서비스를 만들고 테스트하는 단계입니다.
- Playground·Chat·SDK로 빠르게 연동 검증
- 임베딩·리랭커 등 RAG 파이프라인 프로토타입
- 실사용자 트래픽·상용 서비스에는 사용하지 않음
운영계정 (유형2)
개발이 끝난 뒤 실서비스를 오픈할 때 신청합니다. 운영자가 사용 목적·모델·트래픽을 검토합니다.
운영계정은 향후 유료 구독 상품으로 연결될 예정입니다. 요금·플랜은 추후 안내 예정입니다.
개발 → 운영 전환
개발계정으로 연동을 마친 뒤, 서비스 오픈 직전에 운영계정 신청을 제출합니다.
- 내 계정에서 현재 등급·키·신청 상태 확인
- API 신청에서 운영 목적·예상 RPM·필요 모델·서비스 시나리오 작성
- 운영자 심의 (승인/반려·사유는 대시보드·이메일로 안내)
- 승인 시 운영용 키(
sk-ops-*) 추가 발급 — 기존 개발키(sk-dev-*)는 그대로 유지 - 실서비스는 새 운영키로 SDK·서버 환경변수를 맞춘 뒤 오픈 (개발키는 검증용으로 계속 사용 가능)
API 키 정책
| 항목 | 개발계정 | 운영계정 |
|---|---|---|
| 발급 시점 | 가입·개발 신청 직후 (자동) | 운영 승인 직후 (자동) |
| 키 개수 | 1개 (개발·연동용) | 1개 기본 (추가 키는 협의) |
| 전환 시 | — | 개발키 유지 + 운영키 추가 |
| 저장·사용 | 인증키 관리 또는 서버 환경변수. Playground용은 브라우저 저장. | |
| 인증 방식 | Authorization: Bearer <API Key> — API 문서 참고 | |
모델 · 트래픽 한도
모델 접근
| 등급 | 모델 범위 (예정) |
|---|---|
| 개발 | 카탈로그 개발 허용 모델(예: 코더·국산 소형·bge-m3). 회수된 경량 모델(phi/mistral/7b)은 제공하지 않습니다. |
| 운영 | 신청서에 명시한 모델 또는 전체 카탈로그 — 모델 목록 |
모델별 상세·가용 상태는 모델 카탈로그에서 확인하세요. 키에 허용되지 않은 모델 호출 시 403이 반환됩니다.
트래픽 한도
| 한도 종류 | 개발 | 운영 |
|---|---|---|
| 분당 요청 (RPM) | 기본값 (예: 10) | 심의 시 확정 |
| 동시 요청 (in-flight) | 처리 중 요청 수 (분당 아님) | 심의 시 확정 |
| 일일 토큰 상한 | 남용 방지용 (계약 TPM 아님) | 심의 시 확정 |
| 초과 시 | 429 + 포털 안내 · Retry-After | |
음성 전사 (Whisper / STT)
| 항목 | STT 기본 | STT Plus (별도 승인·과금) |
|---|---|---|
| 단일 파일 | 최대 100MB · 권장 mono 16kHz wav/mp3 | |
| 100MB 초과 | 413 — 압축 또는 Plus 신청 | 게이트웨이 자동 분할·병합 (최대 500MB) |
| 확인 방법 | GET /api/capabilities/audio · 응답 gitc_stt · 헤더 X-GITC-STT-* | |
| 엔드포인트 | POST /v1/audio/transcriptions (운영키 · whisper-large-v3) | |
계정별 STT 한도는 인증키 Quota·GET /v1/me/entitlements의 stt 섹션에서 확인합니다.
신청 방법
처음 이용 (개발계정)
운영 전환 (운영계정)
- 로그인 상태에서 운영키 관리 → 운영 전환 신청
- 기관·목적·예상 동시(in-flight)·사용 모델·서비스 시나리오 입력
- 제출 후 신청 이력에서 심의 상태 확인
- 승인되면
sk-ops-*운영키를 인증키 관리에서 확인 (개발키 유지)
FAQ
개발계정만으로 상용 서비스를 열 수 있나요?
아니요. 개발계정은 연동·테스트용이며 트래픽·모델이 제한됩니다. 실서비스는 운영계정 승인이 필요합니다.
운영 승인 후 기존 키는 어떻게 되나요?
개발키(sk-dev-*)는 유지되고, 운영키(sk-ops-*)가 추가됩니다. 실서비스는 운영키를 사용하세요.
법인 회원과 개발/운영 등급은 다른가요?
네. 법인/개인은 가입 유형이고, 개발/운영은 API 사용 등급입니다. 법인도 개발계정으로 시작해 운영계정으로 전환할 수 있습니다.
문서는 어디서 보나요?
개발자 센터는 /docs, API Reference는 /docs/api, 계정·전환은 본 페이지입니다. 장문 가이드는 공개 Hub 문서를 이용하세요.
현재 어떤 기능이 적용되어 있나요?
| 기능 | 상태 |
|---|---|
| 회원가입·로그인 (개인/법인) | 이용 가능 |
| API 신청·운영자 승인/반려 | 이용 가능 |
| 개발계정 자동 승인·등급별 키 정책 | 이용 가능 |
| 운영 승인 시 개발키 유지 + 운영키 추가 | 이용 가능 |
| 키별 일일 토큰 상한 · RPM · 동시(in-flight) | 이용 가능 |
| 유료 구독·결제 | 도입 예정 |