Verifichi la proporzione d’uso dei colori del marchio
Una palette di marca non è soltanto un elenco di colori approvati: richiede anche un equilibrio concreto.
Esegui gratis nel browser
Questo strumento trasforma la copertura misurata in area di pixel in percentuali, quindi confronta ogni colore con la quota definita dalle Sue linee guida. Inserisca la copertura in pixel o in un’altra unità di area coerente, aggiunga obiettivi come 60, 30 e 10 e scelga una tolleranza accettabile. Il risultato mostra quali colori sono conformi, lo scostamento esatto di ciascuno e se il design rispetta complessivamente la regola.
Trasformi la copertura dei pixel in un controllo utile della palette
Un elemento grafico può impiegare tutti i campioni approvati e tuttavia non sembrare coerente con il marchio se le proporzioni sono errate. Una grande area di accento può sovrastare il colore principale, mentre uno spazio neutro eccessivo può rendere spenta una campagna. Parta dalle misure dell’area in pixel dell’intero design o di una regione chiaramente definita. Aggiunga una riga per ogni colore del marchio e mantenga la stessa unità di copertura in tutte le righe. Il conteggio dei pixel è adatto, ma punti quadrati, celle campionate o un’altra unità di area condivisa producono le stesse percentuali. Lo strumento somma i valori e divide ogni colore per il totale positivo, quindi le dimensioni dell’immagine e la scala di misura non influenzano il rapporto. Assegni ai colori nomi per ruolo o codice che i revisori possano riconoscere. Includa tutte le aree pertinenti: omettere un grande sfondo o unire colori non correlati può far descrivere il design sbagliato a un risultato matematicamente corretto.
Definisca gli obiettivi e interpreti gli scostamenti in punti percentuali
Inserisca una percentuale obiettivo per ciascun colore. Gli obiettivi devono totalizzare 100, perché descrivono l’intera area misurata dei colori del marchio. Una gerarchia classica assegna 60 per cento al colore dominante, 30 al secondario e 10 all’accento, ma il calcolatore non presume questa regola: accetta qualsiasi ripartizione completa tra due e venti colori. Lo scostamento è espresso in punti percentuali, non come variazione percentuale relativa. Se un colore occupa il 14 per cento rispetto a un obiettivo di 10, lo scostamento è positivo di 4 punti. Se occupa il 27.5 per cento rispetto a 30, lo scostamento è negativo di 2.5 punti. Un valore positivo indica un uso eccessivo, uno negativo un uso insufficiente. La tolleranza stabilisce quali differenze sono ammesse. Con una tolleranza di 2, superano il controllo gli scostamenti compresi tra meno 2 e più 2. Ogni riga riceve un esito autonomo e la regola complessiva è rispettata soltanto quando tutte sono conformi.
Usi il risultato nella revisione grafica e nel controllo qualità
Consideri i numeri come prove a sostegno della revisione visiva, non come un suo sostituto. Parta dall’esito complessivo, quindi esamini i singoli scostamenti per capire quale modifica produrrà l’effetto maggiore. Quando un accento supera l’obiettivo, ridurre quel colore o aumentare altre aree incluse può ristabilire l’equilibrio; le percentuali sono collegate perché condividono lo stesso totale. Conservi i dati di copertura, la ripartizione obiettivo, la tolleranza e il risultato insieme alla versione del design, così che un altro revisore possa riprodurre la decisione. Nel controllo automatizzato, usi la risposta dell’API per segnalare le risorse non conformi e inviarle a un designer, anziché respingerle senza spiegazioni. Applichi lo stesso metodo di misurazione a ogni risorsa della campagna, poiché antialiasing, soglie di somiglianza, sfumature e ritagli possono cambiare i conteggi. Il calcolo è deterministico e non analizza immagini: valuta i dati di copertura forniti da Lei.
Casi d'uso
Controllare una composizione 60-30-10
Verifichi che i colori dominante, secondario e di accento restino entro la tolleranza concordata per il layout definitivo.
Verificare la coerenza di una campagna
Confronti le proporzioni misurate della palette tra banner, grafiche social e pagine di destinazione con una regola ripetibile.
Aggiungere un controllo qualità grafico
Segnali le risorse esportate quando un colore del marchio supera lo scostamento consentito rispetto all’obiettivo.
Domande frequenti
Quale unità di copertura devo usare?
Usi pixel o qualsiasi unità di area non negativa, purché sia la stessa per tutti i colori. Le percentuali dipendono soltanto dalle proporzioni.
Le percentuali obiettivo devono totalizzare 100?
Sì. Gli obiettivi rappresentano la distribuzione completa dell’area misurata dei colori del marchio e devono quindi totalizzare 100.
Che cosa indica la tolleranza?
È lo scostamento assoluto massimo, in punti percentuali, consentito per ogni colore. Tutti devono essere conformi affinché la regola complessiva sia rispettata.
Questo strumento estrae i colori da un’immagine?
No. Valuta misure di copertura già disponibili; non carica, esamina né classifica alcuna immagine.
Che cosa accade se tutte le coperture sono pari a zero?
La richiesta restituisce un errore di input non valido perché non è possibile calcolare percentuali da un totale non positivo.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La versione per browser può eseguire localmente lo stesso calcolo deterministico.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/date/brand-color-usage-ratio-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}'const res = await fetch("https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"colors": [
{
"color": "Primary blue",
"coverage": 60000,
"target_percentage": 60
},
{
"color": "Secondary gray",
"coverage": 30000,
"target_percentage": 30
},
{
"color": "Accent orange",
"coverage": 10000,
"target_percentage": 10
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/brand-color-usage-ratio-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"colors": [
{
"color": "Primary blue",
"coverage": 60000,
"target_percentage": 60
},
{
"color": "Secondary gray",
"coverage": 30000,
"target_percentage": 30
},
{
"color": "Accent orange",
"coverage": 10000,
"target_percentage": 10
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"colors":[{"color":"Primary blue","coverage":60000,"target_percentage":60},{"color":"Secondary gray","coverage":30000,"target_percentage":30},{"color":"Accent orange","coverage":10000,"target_percentage":10}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/brand-color-usage-ratio-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"colors": [
{
"color": "Primary blue",
"coverage": 60000,
"target_percentage": 60
},
{
"color": "Secondary gray",
"coverage": 30000,
"target_percentage": 30
},
{
"color": "Accent orange",
"coverage": 10000,
"target_percentage": 10
}
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.brand_color_usage_ratio_check",
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |