---
title: "Get the sizes a model version accepts"
description: "Lists the sizes a model version accepts for width/height of POST /v2/image/create. Despite the path, the parameter is a version ID."
canonical: "https://platform.pixai.art/en/docs/api-v2/model/getModelSizeConfig"
last-updated: "2026-11-02"
---

# Get the sizes a model version accepts

Lists the sizes a model version accepts for `width`/`height` of `POST /v2/image/create`. Despite the path, the parameter is a version ID.



A custom `width`/`height` must fall inside one range's `minWidth`–`maxWidth` and `minHeight`–`maxHeight` and be a multiple of its `step`. Presets are ready-made sizes and may lie outside those bounds. Entries whose `accessStatus` is `membership_required` need a higher membership tier than your account has.

## 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.yaml

### Parameters

- `modelVersionId` (in path, string, required)
  The model version ID.

### Responses

- `200`
  The size ranges.
  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)
    Width and height must be multiples of this.
  - `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)
    e.g. `9:16`.
  - `ranges[].presets[].accessStatus` (string, optional)
    Allowed values: `available`, `membership_required`.
- `404`
  `NOT_FOUND`: no such model or version, or it is private. The two cases are not told apart.