API Gateway

전북대학교 멀티 LLM 생성형 AI 서비스 API Gateway에 오신 것을 환영합니다! 🙌

API Gateway는 OpenAI, Anthropic, Google Gemini, xAI, Perplexity 등 주요 AI 제공업체의 모델을 하나의 API 키와 하나의 Base URL로 통합 제공하는 LLM 게이트웨이입니다.

기존에 사용하시던 OpenAI SDK나 Anthropic SDK를 그대로 사용하면서, Base URL만 변경하면 바로 시작할 수 있습니다.

API Gateway란 무엇인가요?

Base URL

API 형식	Base URL
OpenAI 호환 (Chat Completions)	`https://factchat-cloud.mindlogic.ai/v1/gateway`
Anthropic 네이티브 (Messages API)	`https://factchat-cloud.mindlogic.ai/v1/gateway/claude`
OpenAI Responses API	`https://factchat-cloud.mindlogic.ai/v1/gateway`
Google Gemini 네이티브	`https://factchat-cloud.mindlogic.ai/v1/gateway/gemini`

전체 엔드포인트

Method	Path	설명
GET	`/v1/gateway/models/`	모델 목록 (`?type=` 으로 종류별)
GET	`/v1/gateway/models/{model}/`	모델 하나 상세
POST	`/v1/gateway/chat/completions/`	OpenAI 호환 채팅
POST	`/v1/gateway/responses/`	OpenAI Responses API
POST	`/v1/gateway/claude/v1/messages/`	Anthropic Messages API
POST	`/v1/gateway/claude/v1/messages/count_tokens/`	Anthropic 토큰 수 계산
GET	`/v1/gateway/claude/v1/models/`	Anthropic 형식 모델 목록
GET · POST	`/v1/gateway/gemini/v1beta/models/…`	Gemini 네이티브 (목록 · generateContent · 스트리밍)
POST	`/v1/gateway/embeddings/`	임베딩
POST	`/v1/gateway/rerank/`	검색 결과 재정렬
POST	`/v1/gateway/exa/search/` · `…/contents/` · `…/answer/`	웹 검색 (Exa)
POST	`/v1/gateway/guard/`	개인정보 탐지·마스킹
POST	`/v1/gateway/decisions/`	판정 모델 (Jev · OpenAI)
GET · POST	`/v1/gateway/mcp/` (GET) · `/v1/gateway/mcp/{suite}/` (POST)	MCP 도구 묶음
POST	`/v1/gateway/audio/speech/`	음성 합성 (TTS)
POST · GET	`/v1/gateway/audio/transcriptions/` · `…/{operation_id}/`	받아쓰기 (STT) 시작 · 상태
POST	`/v1/gateway/audio/music/`	음악·효과음 생성
POST · GET	`/v1/gateway/images/generate/` · `…/{operation_id}/`	이미지 생성 · 지연된 작업 상태
POST · GET	`/v1/gateway/video/generation/` · `…/{operation_id}/` · `…/download/`	비디오 생성 · 상태 · 다운로드
POST · WS	`/v1/gateway/realtime/sessions/` · 실시간 소켓	실시간 음성 대화·받아쓰기
POST	`/v1/gateway/chatbots/{chatbot_id}/chat/completions/`	스튜디오 챗봇 호출
POST	`/v1/gateway/estimate/`	호출 전 크레딧 견적
GET	`/v1/gateway/credits/`	크레딧 잔액
GET	`/v1/gateway/usage/`	사용량 요약
POST	`/v1/gateway/keys/revoke/`	지금 쓰는 키 해지

제한	값	초과 시
속도 제한	회원당 60초에 120건	`429`
챗봇 채팅 라우트	분당 30건	`429`
작업 상태 폴링 (비디오·이미지·받아쓰기)	회원당 60초에 300건 (속도 제한과 별도)	`429`
크레딧 예약 공용 한도	회원당 60초에 크레딧 예약 300건 (크레딧을 예약하는 모든 호출 합산 — 임베딩·리랭크·가드·앱 사용 포함)	`429`, `Retry-After` 없음
요청 본문 크기	25MB	`413`
TTS `input` 길이	4,000자	`400`

인증

모든 엔드포인트는 전북대학교 멀티 LLM 생성형 AI 서비스 API 키가 필요합니다. 두 가지 헤더 방식을 지원합니다:

자세한 내용은 인증을 참조하세요.

빠른 시작

시작하기 전에 전북대학교 멀티 LLM 생성형 AI 서비스 API 키가 필요합니다. 아직 발급받지 않으셨다면 인증 가이드를 참고해주세요.

하나의 키로 관리하는 API Gateway 알아보기

터미널에서 바로 쓰거나 Claude Code·Codex·OpenCode·Hermes Agent 를 이 키로 돌리려면 Baze CLI를 쓰세요. 코딩 에이전트에게 설치를 맡길 수도 있습니다.

공식 제공업체 문서

API	공식 문서
OpenAI Chat Completions	platform.openai.com/docs/api-reference/chat
OpenAI Responses API	platform.openai.com/docs/api-reference/responses
Anthropic Messages API	docs.anthropic.com/en/api/messages
Google Gemini	ai.google.dev/api/generate-content

위 링크들은 각 제공업체의 모델 호출 요청/응답 형식을 참고하기 위한 문서입니다. API Gateway는 위 전체 엔드포인트에 나열된 경로만 지원하며, 제공업체의 네이티브 리소스 API(예: Google Gemini의 File Search / fileSearchStores, 파일 스토어, 벡터 검색 등)는 Gateway를 통해 호출되지 않습니다. 해당 네이티브 기능이 필요하신 경우 제공업체 API 키로 직접 호출하셔야 합니다.

마지막 수정 날짜: Oct 07, 2026

인증

API Gateway

전체 엔드포인트

호출 제한

인증

빠른 시작

공식 제공업체 문서