---
title: "모델 버전 조회"
description: "생성 엔드포인트가 받는 버전 ID로 모델 버전 하나를 조회합니다. 생성 전에 LoRA의 트리거 워드와 베이스 모델을 확인할 때 사용합니다."
canonical: "https://platform.pixai.art/ko/docs/api-v2/model/getGenerationModelVersion"
last-updated: "2026-11-02"
---

# 모델 버전 조회

생성 엔드포인트가 받는 버전 ID로 모델 버전 하나를 조회합니다. 생성 전에 LoRA의 트리거 워드와 베이스 모델을 확인할 때 사용합니다.



## GET https://api.pixai.art/v2/generation-model-version/{id}

Authentication: optional. Send your API key as `Authorization: Bearer <API key>` to read as your account.

Machine-readable OpenAPI spec: https://platform.pixai.art/openapi-spec.v2.ko.yaml

### Parameters

- `id` (in path, string, required)
  모델 버전 ID입니다.

### Responses

- `200`
  버전.
  Body fields:
  - `id` (string, required)
    버전 ID입니다. `modelVersionId`로 전달하고, LoRA라면 `loras[].modelId`로 전달하세요.
  - `modelId` (string, required)
    이 버전이 속한 모델의 ID.
  - `modelTitle` (string, optional)
  - `name` (string, optional)
    버전 이름.
  - `modelType` (string | null, optional)
    예: `SDXL_MODEL`, `MMDIT26B_MODEL`, `SDXL_LORA`.
  - `loraBaseModelType` (string | null, optional)
    LoRA인 경우 학습 대상 베이스 모델 유형입니다. 이 유형의 베이스 모델을 사용하세요.
  - `loraBaseModelId` (string | null, optional)
    LoRA인 경우 학습에 사용된 베이스 모델입니다.
  - `status` (string | null, optional)
    `available` 상태인 버전만 생성에 사용할 수 있습니다.
  - `extra` (object, optional)
    버전 세부 정보입니다. `triggerWords`에 LoRA의 기본 트리거 워드가 들어 있습니다.
  - `extra.triggerWords` (string, optional)
  - `mediaId` (string | null, optional)
    커버 이미지 미디어 ID.
- `404`
  `NOT_FOUND`: 해당 모델이나 버전이 없거나 비공개입니다. 두 경우는 구분되지 않습니다.
