Mindlogic Logo
Docs
/
API Gateway

모델 목록

마인드로직 운영 Gateway에서 사용 가능한 AI 모델을 조회하는 방법을 안내합니다.
조직에 활성화된 모든 모델을 API로 확인할 수 있으며, 반환된 모델 id를 API 요청의 model 파라미터로 사용하시면 됩니다.
어떤 모델을 사용할 수 있는지 먼저 확인해보세요. 조직의 구독 플랜에 따라 사용 가능한 모델이 다를 수 있습니다.

모델 조회

GET/v1/gateway/models/
조직에서 사용 가능한 모델 목록을 반환합니다. 채팅/LLM 모델뿐 아니라 오디오, 이미지, 비디오 모델도 함께 내려옵니다.

요청 헤더


쿼리 파라미터

type

string

모델 종류로 목록을 거릅니다. llm, audio, image, video 중 하나를 넣거나 쉼표로 여러 개를 나열합니다. 생략하면 모든 종류가 반환됩니다.

모델 종류

각 항목에는 어느 엔드포인트에 속하는 모델인지 알려주는 type 필드가 붙습니다.
type모델엔드포인트
llm채팅 · 추론 모델/v1/gateway/chat/completions/
audioTTS·음악/효과음·음성 텍스트 변환(STT) 모델/v1/gateway/audio/speech/ · /v1/gateway/audio/music/ · /v1/gateway/audio/transcriptions/
image이미지 생성 모델/v1/gateway/images/generate/
video비디오 생성 모델/v1/gateway/video/generation/

응답


응답 필드

id

string

모델 이름. API 요청의 model 파라미터에 그대로 넣습니다.
object

string

항상 "model".
created

integer

모델 등록 시각 (Unix epoch 초).
owned_by

string

제공업체 식별자 (예: openai, claude, gemini).
profile_image_url

string

모델 로고 이미지 URL.
type

string

llm · audio · image · video 중 하나.
audio_client

string

오디오 모델에만 붙습니다. 오디오 레인 세 가지를 이 값으로 구분합니다.
audio_client모델 종류엔드포인트
google_lyria3, elevenlabs음악·효과음/v1/gateway/audio/music/
soniox음성 텍스트 변환(STT)/v1/gateway/audio/transcriptions/
그 밖의 값 (google 등)TTS/v1/gateway/audio/speech/
다른 레인으로 보내면 400이 돌아오고, 응답 메시지가 올바른 엔드포인트를 알려줍니다.

모델 하나 조회

GET/v1/gateway/models/{model}/
모델 하나의 상세를 OpenAI 형식으로 반환합니다. LLM에서 찾지 못하면 조직에 활성화된 오디오·이미지·비디오 카탈로그에서 이어서 찾습니다.

사용 가능 모델 (2026-08-21 기준)

사용 가능한 모델은 조직 설정과 사용자가 속한 그룹의 권한에 따라 달라집니다. 아래 표는 2026년 8월 21일 기준 게이트웨이로 호출 가능한 주요 LLM 목록이며, 최신 세대 위주로 추렸습니다. 표에 없어도 호출되는 모델이 있고 모델은 수시로 추가되므로, 내 계정에서 실제로 쓸 수 있는 목록은 위 /models API로 확인하세요.

Anthropic

모델 ID표시 이름사고 모드웹 검색
claude-sonnet-5Claude Sonnet 5
claude-opus-5Claude Opus 5
claude-fable-5-1Claude Fable 5.1
claude-fable-5Claude Fable 5
claude-opus-4-8Claude 4.8 Opus
claude-haiku-4-5-20251001Claude 4.5 Haiku

OpenAI

모델 ID표시 이름사고 모드웹 검색
gpt-5.6-lunaGPT-5.6 Luna
gpt-5.6-terraGPT-5.6 Terra
gpt-5.6-solGPT-5.6 Sol
gpt-5.5GPT-5.5

Google Gemini

모델 ID표시 이름사고 모드웹 검색
gemini-3.8-flashGemini 3.8 Flash
gemini-3.7-flashGemini 3.7 Flash
gemini-3.6-flashGemini 3.6 Flash
gemini-3.5-flashGemini 3.5 Flash
gemini-3.5-flash-liteGemini 3.5 Flash-Lite
gemini-3.1-pro-previewGemini 3.1 Pro

xAI

모델 ID표시 이름사고 모드웹 검색
grok-4.6Grok 4.6
grok-4.5Grok 4.5
grok-4-1-fastGrok 4.1 Fast

국내 모델

모델 ID표시 이름사고 모드웹 검색
solar-pro4Solar Pro 4

기타 제공업체

모델 ID표시 이름사고 모드웹 검색
google/gemma-4-31B-itGemma 4
qwen3.8-maxQwen 3.8 Max
qwen3.7-plusQwen 3.7 Plus
qwen3.7-maxQwen 3.7 Max
deepseek-v4-proDeepSeek V4 Pro
deepseek-v4-flashDeepSeek V4 Flash
glm-5.2GLM-5.2
kimi-k3Kimi K3
kimi-k2.6Kimi K2.6
seed-2-0-pro-260328Seed 2.0 Pro
seed-2-0-lite-260428Seed 2.0 Lite
sonar-proSonar Pro
sonar-reasoning-proSonar Reasoning Pro
게이트웨이 API로 호출할 수 없는 모델이 있습니다. 아래 모델은 앱 화면에서만 제공되며, 정책상 API로는 제공되지 않습니다. model 파라미터로 호출하면 사용할 수 없다는 오류(403)가 반환됩니다.
  • Super Agent (mindlogic-super-agent): 앱 전용 기능입니다. 영상·음악·음성 등 내장 도구는 게이트웨이 API로 호출할 수 없습니다.
  • 무료 모델 (gpt-5-nano, SAIT 등): 무료 모델은 게이트웨이 API 대상에서 제외됩니다. API에서는 gpt-5.6-luna, gpt-5.6-terra, claude-sonnet-5 등 일반 모델을 사용하세요.
위 표는 채팅/LLM 모델 목록입니다. 오디오, 이미지, 비디오 모델도 같은 엔드포인트에서 내려오며 ?type=audio, ?type=image, ?type=video로 걸러낼 수 있습니다. 파라미터와 과금은 각 API 레퍼런스 페이지를 참조하세요. 오디오 항목에는 audio_client 필드도 있습니다: google_lyria3 또는 elevenlabs/audio/music/용 음악·효과음 모델, soniox/audio/transcriptions/용 STT 모델이고, 그 외는 /audio/speech/용 TTS 모델입니다.

코드 예제


모델별 권장 엔드포인트

모델 제공업체권장 엔드포인트
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/를 사용해보세요. 대부분의 모델이 이 엔드포인트를 통해 사용 가능합니다.

마지막 수정 날짜: Sep 03, 2026

이전

인증

다음

OpenAI SDK

목차