ForHosting KIT · Images

Couleur dominante

Cet outil détermine la couleur dominante d’une image : la teinte la plus représentative, renvoyée avec son code hexadécimal et sa valeur RVB. Utile pour choisir un fond assorti ou un texte lisible. L’analyse se fait dans votre navigateur, gratuitement et sans inscription.

● StableGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Une seule couleur, la plus juste

Là où une palette renvoie plusieurs teintes, cet outil vise l’essentiel : la couleur qui domine visuellement l’image. Il la calcule en tenant compte de la surface occupée par chaque nuance, pas simplement du pixel le plus fréquent, ce qui évite de retenir une couleur anecdotique. Le résultat est une valeur unique, exacte, exprimée en hexadécimal et en RVB. C’est ce dont on a besoin pour poser un fond, un cadre ou un bandeau qui s’accorde d’emblée avec une photo, sans tâtonner avec une pipette.

Des usages concrets pour le web et l’impression

Sur un site, la couleur dominante d’une vignette sert à générer un fond de chargement discret ou une bordure assortie, pour une mise en page qui respire. Dans un document, elle donne la teinte d’un titre ou d’un filet en harmonie avec une image. Pour un produit, connaître la couleur dominante réelle aide à décrire l’article et à le classer. Dans tous ces cas, disposer du code exact plutôt que d’une approximation garantit un rendu propre, identique d’un support à l’autre.

Local, gratuit, sans envoi

Le calcul s’exécute dans votre navigateur : l’image reste sur votre appareil, rien n’est transmis ni stocké, et l’usage est gratuit sans limite. Vous obtenez la couleur d’un visuel confidentiel sans le publier nulle part, ce qui répond à la préoccupation légitime sur le devenir des fichiers déposés en ligne. Aucune inscription n’est requise : vous glissez l’image, vous lisez le code hexadécimal, vous le copiez. L’opération prend quelques secondes et se répète autant de fois qu’il le faut.

Cas d’usage

Un fond de chargement assorti

Le Studio Lumen SAS affiche de grandes photos sur un site. La couleur dominante de chaque image sert de fond pendant le chargement, pour une transition douce plutôt qu’un blanc brutal.

Un titre en harmonie avec une image

Nadia Benali met en page un document illustré. La couleur dominante de la photo de couverture donne la teinte exacte des titres, pour un ensemble cohérent sans choisir au hasard.

Classer des produits par couleur

L’Atelier Garnier SARL trie ses meubles par teinte principale. La couleur dominante réelle de chaque photo aide à ranger le catalogue et à décrire fidèlement les articles en ligne.

Questions fréquentes

Quelle différence avec l’extraction de palette ?

La palette renvoie plusieurs couleurs représentatives ; cet outil ne donne que la teinte dominante, une valeur unique. Choisissez-le quand vous cherchez une seule couleur juste plutôt qu’un ensemble de nuances.

Sous quelle forme est renvoyée la couleur ?

En code hexadécimal et en valeur RVB, directement utilisables dans un fichier CSS, un logiciel graphique ou une fiche produit. Il n’y a rien à convertir à la main.

Mon image part-elle sur un serveur ?

Non. Le calcul se fait dans votre navigateur ; le fichier ne quitte pas votre appareil et n’est pas conservé. Vous pouvez analyser un visuel non publié sans risque.

Est-ce gratuit sans condition ?

Oui. L’usage dans le navigateur est gratuit et sans limite de nombre, sans inscription ni compte. C’est possible parce que le traitement est local, sans coût de serveur à répercuter.

Puis-je récupérer la couleur dominante de nombreuses images ?

Oui, l’API permet de traiter un lot automatiquement, par exemple tout un catalogue. L’usage manuel reste gratuit dans le navigateur ; l’API, pour l’automatisation, est facturée à l’usage en dollars US.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/image/dominant-color \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/dominant-color", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/dominant-color",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/dominant-color", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/dominant-color", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.dominant_color",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_mb`	15
`max_megapixels`	12

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →

Lancer gratuitement