---
title: "색상 팔레트 프리셋 목록 조회"
description: "POST /v2/image/create의 colorPalette에 사용할 PixAI 공식 색상 팔레트를 나열합니다. 사용하려면 프리셋 객체 전체에 \"source\": \"preset\"을 추가해 보내세요."
canonical: "https://platform.pixai.art/ko/docs/api-v2/model/listColorPalettePresets"
last-updated: "2026-11-02"
---

# 색상 팔레트 프리셋 목록 조회

`POST /v2/image/create`의 `colorPalette`에 사용할 PixAI 공식 색상 팔레트를 나열합니다. 사용하려면 프리셋 객체 전체에 `"source": "preset"`을 추가해 보내세요.



`name`은 현지화됩니다. `?lang=ja`(또는 `ko`, `en`)나 `Accept-Language` 헤더를 보내세요.

## GET https://api.pixai.art/v2/color-palettes/presets

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

### Responses

- `200`
  프리셋 목록.
  Body fields:
  - `palettes` (object[], optional)
  - `palettes[].coverUrl` (string | null, optional)
    미리보기 이미지.
  - `palettes[].id` (string, required)
  - `palettes[].name` (string, required)
  - `palettes[].palette` (object, required)
    이미지 전체와, 선택적으로 배경 및 캐릭터의 색상입니다. `overall` 또는 `background`가 필요합니다.
  - `palettes[].palette.overall` (object, optional)
  - `palettes[].palette.overall.colors` (object[], required)
    Items: 1 to 12.
  - `palettes[].palette.overall.colors[].hex` (string, required)
    `#RRGGBB`.
  - `palettes[].palette.overall.colors[].ratio` (number, required)
    이미지에서 차지하는 비율(퍼센트).
    Range: 0 to 100.
  - `palettes[].palette.background` (object, optional)
  - `palettes[].palette.background.colors` (object[], required)
    Items: 1 to 12.
  - `palettes[].palette.background.colors[].hex` (string, required)
    `#RRGGBB`.
  - `palettes[].palette.background.colors[].ratio` (number, required)
    이미지에서 차지하는 비율(퍼센트).
    Range: 0 to 100.
  - `palettes[].palette.character` (object, optional)
  - `palettes[].palette.character.colors` (object[], required)
    Items: 1 to 12.
  - `palettes[].palette.character.colors[].hex` (string, required)
    `#RRGGBB`.
  - `palettes[].palette.character.colors[].ratio` (number, required)
    이미지에서 차지하는 비율(퍼센트).
    Range: 0 to 100.
  - `palettes[].createdAt` (string, required)
  - `palettes[].updatedAt` (string, required)