Color Palette

Витягуйте домінантні кольори із зображення та повертайте їх у вигляді hex-значень кольорів. Використовує квантований частотний аналіз для визначення найпомітніших і візуально відмінних кольорів.

API Endpoint

POST /api/v1/tools/image/color-palette

Приймає дані форми multipart із файлом зображення та необов'язковим полем JSON settings.

Parameters

Parameter	Type	Required	Default	Description
count	integer	No	8	Кількість кольорів для витягування (2-16)
format	string	No	"hex"	Формат кольору: hex, rgb, hsl

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/color-palette \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"count": 6, "format": "hex"}'

Example Response

{
  "filename": "photo.jpg",
  "colors": [
    "#304080",
    "#e0a060",
    "#f0f0f0",
    "#203020",
    "#a0c0e0",
    "#806040"
  ],
  "hex": [
    "#304080",
    "#e0a060",
    "#f0f0f0",
    "#203020",
    "#a0c0e0",
    "#806040"
  ],
  "count": 6
}

Response Fields

Field	Type	Description
filename	string	Очищена назва файлу
colors	array	Масив рядків кольорів у запитаному форматі, впорядкований за домінантністю (найчастіший першим)
hex	array	Масив hex-рядків кольорів (завжди hex, незалежно від налаштування format)
count	number	Кількість витягнутих кольорів

Notes

• Повертає до count домінантних кольорів (за замовчуванням 8, діапазон 2-16), відсортованих за частотою (найпоширеніший першим).
• Зображення внутрішньо зменшується до 100x100 пікселів для аналізу, тож палітра відображає загальний розподіл кольорів, а не дрібні деталі.
• Кольори витягуються за допомогою квантування методом медіанного розрізу, який рекурсивно розділяє групи пікселів уздовж каналу з найширшим діапазоном.
• Альфа-канал видаляється перед аналізом, тож прозорі області не враховуються.
• Це кінцева точка лише для читання. Вона не створює вихідний файл для завантаження або jobId.
• Вхідні дані HEIC, RAW, PSD та SVG автоматично декодуються перед аналізом.