---
title: "List color palette presets"
description: "Lists PixAI's official color palettes for colorPalette of POST /v2/image/create. To use one, send the whole preset object with \"source\": \"preset\" added."
canonical: "https://platform.pixai.art/en/docs/api-v2/model/listColorPalettePresets"
last-updated: "2026-11-02"
---

# List color palette presets

Lists PixAI's official color palettes for `colorPalette` of `POST /v2/image/create`. To use one, send the whole preset object with `"source": "preset"` added.



`name` is localized: pass `?lang=ja` (or `ko`, `en`), or an `Accept-Language` header.

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

### Responses

- `200`
  The presets.
  Body fields:
  - `palettes` (object[], optional)
  - `palettes[].coverUrl` (string | null, optional)
    Preview image.
  - `palettes[].id` (string, required)
  - `palettes[].name` (string, required)
  - `palettes[].palette` (object, required)
    Colors for the whole image and, optionally, the background and characters. `overall` or `background` is required.
  - `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)
    Share of the image, in percent.
    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)
    Share of the image, in percent.
    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)
    Share of the image, in percent.
    Range: 0 to 100.
  - `palettes[].createdAt` (string, required)
  - `palettes[].updatedAt` (string, required)