Paleta de Cores

Extraia as cores dominantes de uma imagem e obtenha-as como valores de cor hexadecimais. Usa análise de frequência quantizada para identificar as cores mais proeminentes e visualmente distintas.

Endpoint da API

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

Aceita dados de formulário multipart com um arquivo de imagem e um campo JSON settings opcional.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
count	integer	Não	8	Número de cores a extrair (2-16)
format	string	Não	"hex"	Formato da cor: hex, rgb, hsl

Exemplo de Requisição

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"}'

Exemplo de Resposta

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

Campos da Resposta

Campo	Tipo	Descrição
filename	string	Nome de arquivo higienizado
colors	array	Array de strings de cor no formato solicitado, ordenado por dominância (mais frequente primeiro)
hex	array	Array de strings de cor hexadecimais (sempre hexadecimal, independentemente da configuração format)
count	number	Número de cores extraídas

Notas

• Retorna até count cores dominantes (padrão 8, faixa 2-16), ordenadas por frequência (mais comuns primeiro).
• A imagem é redimensionada internamente para 100x100 pixels para a análise, então a paleta representa a distribuição geral de cores em vez de pequenos detalhes.
• As cores são extraídas usando quantização por corte mediano, que divide recursivamente as populações de pixels ao longo do canal com a maior amplitude.
• O canal alfa é removido antes da análise, então áreas transparentes não são consideradas.
• Este é um endpoint somente leitura. Ele não produz um arquivo de saída baixável nem um jobId.
• Entradas HEIC, RAW, PSD e SVG são decodificadas automaticamente antes da análise.