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는 여러 AI 제공업체의 API를 하나의 통합 엔드포인트로 제공하는 프록시 서비스입니다.
기존에는 OpenAI, Anthropic, Google 등 각 제공업체별로 별도의 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/ | 비동기 비디오 생성 |
인증
모든 엔드포인트는 팩트챗 API 키가 필요합니다. 두 가지 헤더 방식을 지원합니다:
자세한 내용은 인증을 참조하세요.
빠른 시작
시작하기 전에 팩트챗 API 키가 필요합니다. 아직 발급받지 않으셨다면 인증 가이드를 참고해주세요.
공식 제공업체 문서
| 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 키로 직접 호출하셔야 합니다.마지막 수정 날짜: Feb 24, 2026