모델 목록
팩트챗 Gateway에서 사용 가능한 AI 모델을 조회하는 방법을 안내합니다.
조직에 활성화된 모든 모델을 API로 확인할 수 있으며, 반환된 모델
id를 API 요청의 model 파라미터로 사용하시면 됩니다.어떤 모델을 사용할 수 있는지 먼저 확인해보세요. 조직의 구독 플랜에 따라 사용 가능한 모델이 다를 수 있습니다.
모델 조회
GET
/v1/gateway/models/조직에서 사용 가능한 모델 목록을 반환합니다. 채팅/LLM 모델뿐 아니라 오디오, 이미지, 비디오 모델도 함께 내려옵니다.
요청 헤더
쿼리 파라미터
type
모델 종류로 목록을 거릅니다. string
llm, audio, image, video 중 하나를 넣거나 쉼표로 여러 개를 나열합니다. 생략하면 모든 종류가 반환됩니다.모델 종류
각 항목에는 어느 엔드포인트에 속하는 모델인지 알려주는
type 필드가 붙습니다.type | 모델 | 엔드포인트 |
|---|---|---|
llm | 채팅 · 추론 모델 | /v1/gateway/chat/completions/ |
audio | TTS 모델 | /v1/gateway/audio/speech/ |
image | 이미지 생성 모델 | /v1/gateway/images/generate/ |
video | 비디오 생성 모델 | /v1/gateway/video/generation/ |
응답
주요 사용 가능 모델 (2026-07-31 기준)
사용 가능한 모델은 조직(테넌트) 설정과 사용자가 속한 그룹의 권한에 따라 달라집니다. 실제 목록은 위 API로 직접 조회하는 것이 가장 정확하며, 아래 표는 각 제공업체별 최신 모델 빠른 참조용입니다.
Anthropic
| 모델 ID | 표시 이름 | 사고 모드 |
|---|---|---|
claude-fable-5 | Claude Fable 5 | ✓ |
claude-opus-5 | Claude Opus 5 | ✓ |
claude-sonnet-5 | Claude Sonnet 5 | ✓ |
claude-opus-4-8 | Claude 4.8 Opus | ✓ |
claude-opus-4-7 | Claude 4.7 Opus | ✓ |
claude-opus-4-6 | Claude 4.6 Opus | ✓ |
claude-sonnet-4-6 | Claude 4.6 Sonnet | ✓ |
claude-sonnet-4-5-20250929 | Claude 4.5 Sonnet | ✓ |
claude-haiku-4-5-20251001 | Claude 4.5 Haiku | ✓ |
OpenAI
| 모델 ID | 표시 이름 | 사고 모드 |
|---|---|---|
gpt-5.5 | GPT-5.5 | ✓ |
gpt-5.4 | GPT-5.4 | ✓ |
gpt-5.4-mini | GPT-5.4 mini | ✓ |
gpt-5.4-nano | GPT-5.4 nano | ✓ |
gpt-5.3-chat-latest | GPT-5.3 Chat | — |
gpt-5.3-codex | GPT-5.3 Codex | ✓ |
gpt-5.2 | GPT-5.2 | ✓ |
gpt-5.1 | GPT-5.1 | ✓ |
gpt-5.1-codex-max | GPT-5.1 Codex Max | ✓ |
Google Gemini
| 모델 ID | 표시 이름 | 사고 모드 |
|---|---|---|
gemini-3.5-flash | Gemini 3.5 Flash | ✓ |
gemini-3.1-pro-preview | Gemini 3.1 Pro | ✓ |
gemini-3.1-flash-lite | Gemini 3.1 Flash Lite | ✓ |
gemini-3-flash-preview | Gemini 3 Flash | ✓ |
gemini-2.5-pro | Gemini 2.5 Pro | — |
gemini-2.5-flash | Gemini 2.5 Flash | — |
기타 제공업체
| 모델 ID | 표시 이름 | 비고 |
|---|---|---|
grok-4-1-fast | Grok 4.1 Fast | |
grok-4 | Grok 4 | |
solar-pro3 | Solar Pro 3 | |
sonar-pro | Sonar Pro | Perplexity, 웹 검색 |
sonar-reasoning-pro | Sonar Reasoning Pro | Perplexity |
게이트웨이 API로 호출할 수 없는 모델이 있습니다. 아래 모델은 앱 화면에서만 제공되며, 정책상 API로는 제공되지 않습니다.
model 파라미터로 호출하면 사용할 수 없다는 오류(403)가 반환됩니다.- Super Agent (
mindlogic-super-agent): 앱 전용 기능입니다. 영상·음악·음성 등 내장 도구는 게이트웨이 API로 호출할 수 없습니다. - 무료 모델 (
gpt-5-nano,gpt-4.1-nano, SAIT 등): 무료 모델은 게이트웨이 API 대상에서 제외됩니다. API에서는gpt-5.4-nano,gpt-5.4,claude-sonnet-4-6등 일반 모델을 사용하세요.
위 표는 채팅/LLM 모델 목록입니다. 오디오, 이미지, 비디오 모델도 같은 엔드포인트에서 내려오며
?type=audio, ?type=image, ?type=video로 걸러낼 수 있습니다. 파라미터와 과금은 각 API 레퍼런스 페이지를 참조하세요.코드 예제
모델별 권장 엔드포인트
| 모델 제공업체 | 권장 엔드포인트 |
|---|---|
| Anthropic | /v1/gateway/chat/completions/ 또는 /v1/gateway/claude/v1/messages/ |
| OpenAI (채팅) | /v1/gateway/chat/completions/ |
| OpenAI (o-시리즈 추론) | /v1/gateway/responses/ |
| Google Gemini | /v1/gateway/chat/completions/ |
| OpenAI (Codex) | /v1/gateway/responses/ |
| 기타 제공업체 | /v1/gateway/chat/completions/ |
참고
- 조직에 활성화된 모델만 이 목록에 표시됩니다
- 모델 가용성은 구독 플랜에 따라 다릅니다
- API 요청에서
id필드를model파라미터로 사용하세요 type필드로 해당 모델의 엔드포인트를 확인하거나, 조회 단계에서?type=으로 미리 걸러내세요
어떤 엔드포인트를 사용해야 할지 모르겠다면,
/v1/gateway/chat/completions/를 사용해보세요. 대부분의 모델이 이 엔드포인트를 통해 사용 가능합니다.마지막 수정 날짜: Aug 05, 2026