ForHosting KIT · Immagini e foto

Estragga la palette dei colori dominanti da un’immagine

Quattro tonalità di rosso e blu campionate, chiedendo 2 colori, diventano due tinte, #F24538 e #1E89E6, ciascuna con 50 pixel su 100. Le tonalità vicine si fondono, così ottiene una palette corta invece di colori quasi doppi. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
N
2
Ottiene
Richiesto
2
Restituito
2
Pixel totali
100

Trasformi un elenco rappresentativo di pixel dell’immagine in una palette di colori compatta e utile. Questa capacità raggruppa valori RGB vicini, ordina i gruppi in base alla loro presenza ponderata e restituisce ogni colore dominante sia come campione esadecimale sia come canali RGB, insieme al conteggio dei pixel e alla quota sul campione fornito. È pensata per flussi che hanno già campionato o contato i pixel e richiedono un riepilogo deterministico senza caricare né decodificare l’immagine originale.

Prepari campioni di pixel rappresentativi

Inizi con pixel campionati nell’intera immagine, invece di limitarsi a un angolo comodo. Ogni record contiene i valori dei canali rosso, verde e blu da 0 a 255. Se la pre-elaborazione ha già contato i colori identici, aggiunga count al record; altrimenti lo ometta e ogni record rappresenterà un pixel.

I record ponderati sono particolarmente utili per immagini con ampie aree uniformi, perché conservano la frequenza reale senza costringerLa a ripetere migliaia di volte lo stesso oggetto RGB. Il campionamento deve essere equilibrato nello spazio. Una griglia semplice, un passo uniforme o un’anteprima ridimensionata offrono di solito una rappresentazione migliore rispetto ai primi pixel nell’ordine del file.

Escluda i pixel trasparenti, a meno che siano già stati composti sullo sfondo che sarà visibile: un valore RGB invisibile non deve influenzare una palette visibile. L’algoritmo unisce i duplicati esatti prima del raggruppamento; pertanto, record ripetuti e un record equivalente dotato di conteggio producono lo stesso risultato.

Comprenda il raggruppamento deterministico dei colori

Scelga n come numero massimo di colori dominanti desiderati. Deve essere un intero di almeno 1 e la capacità restituisce meno colori se il campione contiene meno valori RGB distinti. I centri vengono inizializzati in modo deterministico da campioni frequenti e ben separati, poi perfezionati con un raggruppamento ponderato e limitato nello spazio RGB.

Non intervengono semi casuali, orologi, servizi di rete o modelli, quindi un input identico produce un output identico. Le tonalità vicine possono confluire nello stesso gruppo: artefatti di compressione, antialiasing, sfumature e piccole variazioni di luce contribuiscono così a un campione rappresentativo, invece di frammentare la risposta. Il valore RGB rappresentativo è la media ponderata del gruppo, arrotondata a canali interi validi, mentre il valore esadecimale deriva dagli stessi canali.

I gruppi sono ordinati per conteggio dei pixel, con uno spareggio esadecimale stabile. La distanza RGB è volutamente semplice e prevedibile: fornisce un riepilogo pratico, non un sistema percettivo per lavorazioni di stampa in cui il colore è critico.

Utilizzi conteggi e quote nei processi successivi

La risposta contiene un array colors ordinato dal conteggio di pixel rappresentati più alto al più basso. Ogni elemento include hex, un oggetto RGB, count e share. Usi il primo campione come stima dell’accento dominante, ma ne esamini la quota prima di presumere che rappresenti gran parte dell’immagine.

Un colore principale con quota vicina alla metà è un segnale visivo molto più forte del primo colore in una palette equilibrata di cinque tonalità. Per l’automazione, conservi l’intero elenco ordinato, così potrà modificare le soglie senza elaborare nuovamente i campioni. Valori non validi e n minore di 1 producono errori espliciti.

Generi temi adattivi per l’interfaccia

Scelga accenti, trattamenti del testo o sfondi provvisori da una palette ordinata e usi la quota per non enfatizzare eccessivamente un colore secondario.

Etichetti per colore le immagini dei prodotti

Converta i pixel campionati del catalogo in caratteristiche cromatiche stabili per filtri, ricerca per somiglianza, gruppi commerciali e controlli qualità.

Riassuma risorse creative su larga scala

Conservi palette compatte invece dei pixel completi quando confronta campagne, rileva variazioni visive o prepara proposte per tavole d’ispirazione.

Perché la risposta può contenere meno di n colori?

Il valore richiesto è un massimo. Se l’input contiene meno valori RGB distinti, vengono restituiti soltanto i gruppi disponibili.

Devo ripetere i pixel identici?

No. Fornisca un record RGB con count impostato sulla frequenza, oppure ripeta il record; i duplicati esatti vengono uniti con peso equivalente.

Sono supportati i pixel trasparenti?

L’input contiene soltanto campioni RGB. Escluda i pixel invisibili o componga la trasparenza sullo sfondo previsto prima di creare l’elenco.

Come devo campionare i pixel della mia immagine?

Distribuisca il campione su tutta l’immagine: una griglia semplice, un passo regolare o un’anteprima ridotta vanno bene. Prendere i primi pixel del file o un solo angolo può dare una palette che non rappresenta l’immagine.

Perché tonalità simili finiscono in un solo colore?

Le tonalità vicine vengono raggruppate apposta, così segni di compressione, bordi sfumati, sfumature e piccoli cambi di luce contribuiscono a una tinta rappresentativa invece di dividersi in voci quasi uguali. Ogni tinta è la media ponderata del suo gruppo.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/image/dominant-palette

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/image/dominant-palette \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pixels":[{"r":244,"g":67,"b":54,"count":40},{"r":235,"g":76,"b":63,"count":10},{"r":33,"g":150,"b":243,"count":30},{"r":25,"g":118,"b":210,"count":20}]}'
{
  "pixels": [
    {
      "r": 244,
      "g": 67,
      "b": 54,
      "count": 40
    },
    {
      "r": 235,
      "g": 76,
      "b": 63,
      "count": 10
    },
    {
      "r": 33,
      "g": 150,
      "b": 243,
      "count": 30
    },
    {
      "r": 25,
      "g": 118,
      "b": 210,
      "count": 20
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.dominant_palette",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb15
max_megapixels12
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Utilizzi conteggi e quote nei processi successivi

Share equivale al conteggio del gruppo diviso per il totale ponderato dei pixel ed è arrotondato a sei cifre decimali per ottenere JSON stabile. La risposta indica inoltre la dimensione della palette richiesta, il numero effettivamente restituito e total_pixels; chi la utilizza può così verificare la copertura e distinguere un piccolo campione da un’immagine campionata ampiamente. Il browser e l’API usano lo stesso risolutore puro; ogni chiamata API costa $0.002.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso risolutore deterministico può essere eseguito anche nel browser.

Che cosa accade se n è minore di 1?

La richiesta non riesce e restituisce un errore invalid_input, perché una palette non può richiedere meno di un gruppo.

Leggi la documentazione completa del KIT →