---
title: "모델 버전이 지원하는 크기 조회"
description: "POST /v2/image/create의 width/height에 모델 버전이 받는 크기를 나열합니다. 경로와 달리 파라미터는 버전 ID입니다."
canonical: "https://platform.pixai.art/ko/docs/api-v2/model/getModelSizeConfig"
last-updated: "2026-11-02"
---

# 모델 버전이 지원하는 크기 조회

`POST /v2/image/create`의 `width`/`height`에 모델 버전이 받는 크기를 나열합니다. 경로와 달리 파라미터는 버전 ID입니다.



사용자 지정 `width`/`height`는 한 범위의 `minWidth`–`maxWidth`와 `minHeight`–`maxHeight` 안에 들어가고 그 `step`의 배수여야 합니다. 프리셋은 미리 정의된 크기로, 이 범위를 벗어날 수 있습니다. `accessStatus`가 `membership_required`인 항목은 현재 계정보다 높은 멤버십 등급이 필요합니다.

## GET https://api.pixai.art/v2/generation-model/{modelVersionId}/size-config

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

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

### Responses

- `200`
  크기 범위.
  Body fields:
  - `ranges` (object[], optional)
  - `ranges[].name` (string, optional)
  - `ranges[].minWidth` (integer, optional)
  - `ranges[].maxWidth` (integer, optional)
  - `ranges[].minHeight` (integer, optional)
  - `ranges[].maxHeight` (integer, optional)
  - `ranges[].step` (integer, optional)
    너비와 높이는 이 값의 배수여야 합니다.
  - `ranges[].accessStatus` (string, optional)
    Allowed values: `available`, `membership_required`.
  - `ranges[].presets` (object[], optional)
  - `ranges[].presets[].id` (string, optional)
  - `ranges[].presets[].width` (integer, optional)
  - `ranges[].presets[].height` (integer, optional)
  - `ranges[].presets[].ratioLabel` (string, optional)
    예: `9:16`.
  - `ranges[].presets[].accessStatus` (string, optional)
    Allowed values: `available`, `membership_required`.
- `404`
  `NOT_FOUND`: 해당 모델이나 버전이 없거나 비공개입니다. 두 경우는 구분되지 않습니다.