User Guide

계정 유형 · 개발 → 운영 전환

공공데이터포털의 개발계정(유형1)·운영계정(유형2)과 같은 방식으로, 연동 개발과 실서비스를 분리합니다. 플랫폼 이용 가이드는 사용자 포털 문서에서 제공합니다.

문서 제공 정책 — 내부 저장소는 폐쇄 운영 예정입니다. API 사용법·계정 정책·온보딩 절차 등 대외 공개 정보는 본 포털(/docs)을 기준으로 합니다.

개요

GITC AI Service Hub은 개발 단계와 운영(실서비스) 단계를 분리해 API 키·모델 접근·트래픽 한도를 다르게 적용합니다. 서비스를 만들 때는 개발계정으로 빠르게 연동하고, 오픈 전에는 운영계정으로 전환·심사를 받습니다.

구분	개발계정 (유형1)	운영계정 (유형2)
목적	API 연동·프로토타입·내부 테스트	실서비스·대고객 트래픽
승인	자동 승인 (가입·신청 즉시)	심의 승인 (운영자 검토, 영업일 2~3일)
API 키	신규 발급	재발급 (승인 시 기존 키 자동 폐기)
모델	일부 모델 (경량·체험 위주)	신청 시 선택 또는 전체 모델
트래픽	약 1만 건/일	약 10만 건/일 (협의 가능)
과금	무료 (개발용)	유료 구독 (도입 예정)

회원 유형 vs 사용 등급

헷갈리기 쉬운 두 축을 구분합니다.

축	값	의미
회원 유형 가입 시	개인 · 법인	가입·로그인 시 수집하는 신원 정보. 법인은 회사명·사업자번호·담당자 정보를 추가로 받습니다. 법인 회원가입
사용 등급 도입 예정	개발 · 운영	API 키 권한·모델·일일 한도를 결정합니다. 한 계정이 개발 → 운영으로 전환할 수 있습니다.

개발계정 (유형1)

Open API로 서비스를 만들고 테스트하는 단계입니다.

1. 회원가입개인 또는 법인

→

2. 개발계정 신청자동 승인

→

3. API 키 발급즉시 사용

→

4. 연동·테스트일부 모델

Playground·Chat·SDK로 빠르게 연동 검증
임베딩·리랭커 등 RAG 파이프라인 프로토타입
실사용자 트래픽·상용 서비스에는 사용하지 않음

운영계정 (유형2)

개발이 끝난 뒤 실서비스를 오픈할 때 신청합니다. 운영자가 사용 목적·모델·트래픽을 검토합니다.

1. 운영 신청API 신청서

→

2. 심의 대기2~3 영업일

→

3. 승인모델·한도 확정

→

4. 키 재발급기존 키 폐기

운영계정은 향후 유료 구독 상품으로 연결될 예정입니다. 요금·플랜은 요금 안내를 참고하세요.

개발 → 운영 전환

개발계정으로 연동을 마친 뒤, 서비스 오픈 직전에 운영계정 신청을 제출합니다.

내 계정에서 현재 등급·키·신청 상태 확인
API 신청에서 운영 목적·예상 RPM·필요 모델·서비스 시나리오 작성
운영자 심의 (승인/반려·사유는 대시보드·이메일로 안내)
승인 시 기존 개발 키 전부 폐기 → 운영용 키 1개(또는 정책에 따른 수) 재발급
새 키로 SDK·서버 환경변수 교체 후 실서비스 오픈

주의 — 운영 승인 후에는 개발 키가 즉시 무효화됩니다. 배포 파이프라인에 새 키 반영을 미리 준비하세요.

API 키 정책

항목	개발계정	운영계정
발급 시점	가입·개발 신청 직후 (자동)	운영 승인 직후 (자동)
키 개수	1개 (개발·연동용)	1개 기본 (추가 키는 협의)
전환 시	—	기존 키 전량 회수 후 재발급
저장·사용	인증키 관리 또는 서버 환경변수. Playground용은 브라우저 저장.
인증 방식	`Authorization: Bearer <API Key>` — API 문서 참고

모델 · 트래픽 한도

모델 접근

등급	모델 범위 (예정)
개발	경량 채팅·코딩 모델 일부 (예: qwen2.5-7b, mistral-7b, phi-4, bge-m3 등)
운영	신청서에 명시한 모델 또는 전체 카탈로그 — 모델 목록

모델별 상세·가용 상태는 모델 카탈로그에서 확인하세요. 키에 허용되지 않은 모델 호출 시 403이 반환됩니다.

트래픽 한도

한도 종류	개발	운영
일일 요청 수	~10,000건/일	~100,000건/일 (협의)
분당 요청(RPM)	신청서 기준 기본값	승인 시 확정
초과 시	`429 Too Many Requests` + `Retry-After` 헤더

신청 방법

처음 이용 (개발계정)

회원가입 또는 법인 회원가입
로그인 후 프로젝트를 만들고 개발 API를 신청
API 문서·Playground로 연동 테스트

운영 전환 (운영계정)

로그인 상태에서 API 신청 접속
기관·회사명, 예상 RPM, 사용 모델, 서비스 시나리오 입력
제출 후 신청 이력에서 심의 상태 확인
승인되면 새 운영 키를 인증키 관리에서 확인

FAQ

개발계정만으로 상용 서비스를 열 수 있나요?

아니요. 개발계정은 연동·테스트용이며 트래픽·모델이 제한됩니다. 실서비스는 운영계정 승인이 필요합니다.

운영 승인 후 기존 키는 어떻게 되나요?

개발 단계에서 쓰던 키는 모두 폐기되고, 운영용 키만 유효합니다. 애플리케이션 설정을 반드시 갱신하세요.

법인 회원과 개발/운영 등급은 다른가요?

네. 법인/개인은 가입 유형이고, 개발/운영은 API 사용 등급입니다. 법인도 개발계정으로 시작해 운영계정으로 전환할 수 있습니다.

문서는 어디서 보나요?

API 레퍼런스는 /docs, 계정·전환 가이드는 본 페이지(/docs/accounts)입니다. 내부 GitHub 저장소가 폐쇄되어도 포털 문서가 공식 안내입니다.

현재 어떤 기능이 적용되어 있나요?

기능	상태
회원가입·로그인 (개인/법인)	이용 가능
API 신청·운영자 승인/반려	이용 가능
개발계정 자동 승인·등급별 키 정책	도입 예정
운영 승인 시 기존 키 자동 폐기	도입 예정
키별 일일 요청 한도	도입 예정
유료 구독·결제	도입 예정