API Gateway

마인드로직 운영 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`

전체 엔드포인트

Method	Path	설명
GET	`/v1/gateway/models/`	사용 가능한 모델 목록 조회
POST	`/v1/gateway/chat/completions/`	OpenAI 호환 채팅 완성
POST	`/v1/gateway/claude/v1/messages/`	Anthropic 네이티브 Messages API
POST	`/v1/gateway/responses/`	OpenAI Responses API (o-시리즈)
POST	`/v1/gateway/audio/speech/`	텍스트 음성 변환 (Google Gemini TTS)
POST	`/v1/gateway/images/generate/`	이미지 생성
POST	`/v1/gateway/video/generation/`	비동기 비디오 생성
GET	`/v1/gateway/models/{model}/`	모델 하나의 상세 조회
POST	`/v1/gateway/chatbots/{chatbot_id}/chat/completions/`	특정 챗봇을 API로 호출 (OpenAI 호환)
GET	`/v1/gateway/claude/v1/models`	Anthropic 형식 모델 목록
GET	`/v1/gateway/images/generate/{operation_id}/`	비동기 이미지 생성 상태 폴링
GET	`/v1/gateway/credits/`	크레딧 잔액 조회

제한	값	초과 시
속도 제한	회원당 60초에 120건	`429`
챗봇 채팅 라우트	분당 30건	`429`
크레딧 예약 공용 한도	회원당 분당 300건 (채팅·오디오·이미지·비디오 합산)	`429`
요청 본문 크기	25MB	`413`
TTS `input` 길이	4,000자	`400`

인증

모든 엔드포인트는 마인드로직 운영 API 키가 필요합니다. 두 가지 헤더 방식을 지원합니다:

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

빠른 시작

시작하기 전에 마인드로직 운영 API 키가 필요합니다. 아직 발급받지 않으셨다면 인증 가이드를 참고해주세요.

API Gateway 시작하기

공식 제공업체 문서

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 키로 직접 호출하셔야 합니다.

마지막 수정 날짜: Aug 25, 2026

인증

API Gateway

전체 엔드포인트

호출 제한

인증

빠른 시작

공식 제공업체 문서