계정 유형 · 개발 → 운영 전환
공공데이터포털의 개발계정(유형1)·운영계정(유형2)과 같은 방식으로, 연동 개발과 실서비스를 분리합니다. 플랫폼 이용 가이드는 공개 개발자 문서와 본 포털에서 제공합니다.
/docs·/guide)을 기준으로 합니다.
내부 운영 저장소의 런북·IP·키 절차는 공개하지 않습니다.
개요
Open AI Service Hub은 개발키 · 실증키 · 운영키를 구분해 API 키·모델 접근·트래픽 한도를 다르게 적용합니다. 개발·실증은 즉시 발급(각 1개), 운영키는 기관 소속 계정의 이용문의 후 관리자 승인으로 발급됩니다.
| 구분 | 개발키 | 실증키 | 운영키 |
|---|---|---|---|
| 목적 | API 연동·프로토타입 | PoC·파일럿 | 기관 실서비스 |
| 승인 | 즉시 발급 | 즉시 발급 | 이용문의 → 심의 |
| API 키 | sk-dev-* (계정당 1) | sk-poc-* (계정당 1) | sk-ops-* (기관) |
| 일 토큰 / RPM / 동시 | 2천만 / 10 / 1 | 2천만 / 20 / 2 | 5천만 / 40 / 4 |
| 일 트랜잭션 (키별) | 500 / 10,000 | 750 / 15,000 | 2,000 / 40,000 |
| STT 단일/Plus | 25MB / 500MB | 50MB / 500MB | 100MB / 500MB |
| 과금 | 무료 | 무료 | 유료 구독(도입 예정) |
숫자는 일반 호출 / 임베딩·리랭크입니다. 성공(2xx)만 키별로 세고 KST 자정에 초기화합니다. 개발키 임베딩·리랭크는 10,000건, 실증키는 15,000건, 운영키는 40,000건입니다. 키를 여러 개 가지면 한도는 키마다 더해집니다. 실패한 호출, Playground, 작업 상태 조회는 횟수에 넣지 않습니다. 한도를 넘기면 429(quota_txn_daily / quota_txn_daily_embed)와 Retry-After를 반환합니다.
운영키에는 EXAONE·GR00T 등 유료·NC 라이선스 모델이 포함되지 않습니다. STT 길이 한도(플랫폼): 10,800초 / 청크 550초 / 오버랩 50초.
회원 유형 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) | 처리 중 요청 수 (분당 아님) | 심의 시 확정 |
| 일일 토큰 상한 | 2,000만 (계약 TPM 아님) | 5,000만 (심의로 조정 가능) |
| 일 트랜잭션 | 키별 일반 500(개발) · 750(실증) · 임베딩·리랭크 10,000(개발) · 15,000(실증). 성공(2xx)만, KST 자정 초기화 | 키별 일반 2,000 · 임베딩·리랭크 40,000 |
| 초과 시 | 429 + Retry-After (토큰 quota_tpm_daily, 호출 quota_txn_daily / quota_txn_daily_embed) | |
음성 전사 (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 섹션에서 확인합니다.
신청 방법
처음 이용 (개발계정)
- 회원가입 또는 기관 소속 회원가입
- 로그인 후 개발키를 신청
- API 문서·Playground로 연동 테스트
운영 전환 (운영계정)
- 로그인 상태에서 운영키 관리 → 운영 전환 신청
- 기관·목적·예상 동시(in-flight)·사용 모델·서비스 시나리오 입력
- 제출 후 신청 이력에서 심의 상태 확인
- 승인되면
sk-ops-*운영키를 인증키 관리에서 확인 (개발키 유지)
FAQ
개발계정만으로 상용 서비스를 열 수 있나요?
아니요. 개발계정은 연동·테스트용이며 트래픽·모델이 제한됩니다. 실서비스는 운영계정 승인이 필요합니다.
운영 승인 후 기존 키는 어떻게 되나요?
개발키(sk-dev-*)는 유지되고, 운영키(sk-ops-*)가 추가됩니다. 실서비스는 운영키를 사용하세요.
기관 소속 회원과 개발/운영 등급은 다른가요?
네. 기관 소속/개인은 가입 유형이고, 개발/운영은 API 사용 등급입니다. 기관 소속도 개발계정으로 시작해 운영계정으로 전환할 수 있습니다.
문서는 어디서 보나요?
개발자 센터는 /docs, API Reference는 /docs/api, 계정·전환은 본 페이지입니다. 장문 가이드는 공개 Hub 문서를 이용하세요.
현재 어떤 기능이 적용되어 있나요?
| 기능 | 상태 |
|---|---|
| 회원가입·로그인 (개인/기관 소속) | 이용 가능 |
| API 신청·운영자 승인/반려 | 이용 가능 |
| 개발계정 자동 승인·등급별 키 정책 | 이용 가능 |
| 운영 승인 시 개발키 유지 + 운영키 추가 | 이용 가능 |
| 키별 일일 토큰 상한 · RPM · 동시(in-flight) | 이용 가능 |
| 키별 일 트랜잭션 (개발 500/10,000 · 실증 750/15,000 · 운영 2,000/40,000) | 이용 가능 |
| 유료 구독·결제 | 도입 예정 |