---
title: "カラーパレットプリセット一覧の取得"
description: "POST /v2/image/create の colorPalette に使う PixAI 公式カラーパレットを一覧表示します。使用するには、プリセットオブジェクト全体に \"source\": \"preset\" を追加して送信します。"
canonical: "https://platform.pixai.art/ja/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.ja.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)