ForHosting KIT · Images

Blurhash

Le blurhash transforme une image en une courte chaîne de caractères qui encode ses couleurs sous forme d’aperçu flou. Affichée pendant le chargement de la vraie photo, elle évite le rectangle gris et donne un rendu progressif et fluide. Cet outil calcule cette chaîne dans votre navigateur, gratuitement, sans envoyer le fichier ni exiger d’inscription.

● StableGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

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

À quoi sert cette chaîne

Un blurhash tient en une vingtaine de caractères que l’on stocke à côté de l’image, souvent en base de données. Au chargement d’une page, le navigateur affiche instantanément cet aperçu flou coloré, puis la photo nette prend sa place une fois téléchargée. Le rendu est plus agréable qu’un vide gris et fait paraître le site plus rapide. C’est une technique répandue sur les galeries, les fils d’actualité et les applications où l’on charge beaucoup d’images sans vouloir stocker une lourde miniature pour chacune.

Léger là où une miniature est lourde

Là où une vraie vignette pèse plusieurs kilo-octets et demande une requête réseau, le blurhash est une simple chaîne de texte, quasi gratuite à stocker et à transmettre. On le range dans le même enregistrement que l’URL de l’image, sans fichier supplémentaire à gérer. Le décodage, côté navigateur ou application, reconstitue l’aperçu flou à la taille voulue. Pour une liste de centaines d’éléments, cette différence de poids se traduit par un affichage plus réactif et une consommation de données réduite pour l’utilisateur.

Calcul local et gratuit

La génération s’exécute dans votre navigateur : l’image ne quitte pas votre appareil et rien n’est conservé. L’usage est gratuit et sans limite de nombre, ce qui convient à un travail ponctuel. Pour intégrer le calcul à une chaîne de publication — générer le blurhash de chaque image importée dans votre application —, la même capacité s’appelle via l’API, avec l’arrivée prochaine des autres canaux. L’essentiel du besoin d’un développeur reste couvert gratuitement ici, sans compte à créer.

Cas d’usage

Une galerie qui charge en douceur

Le Studio Lumen SAS publie un portfolio de nombreuses photos. Chaque image reçoit son blurhash, affiché le temps du chargement, ce qui donne une navigation fluide même sur une connexion lente.

Un fil d’images réactif

Un développeur intègre un flux de photos dans une application. Le blurhash stocké à côté de chaque URL évite les rectangles gris et améliore la perception de rapidité au défilement.

Des aperçus légers en base de données

Une petite boutique en ligne veut des aperçus sans multiplier les miniatures. La chaîne blurhash de chaque produit tient dans le même enregistrement, sans fichier supplémentaire à héberger.

Questions fréquentes

Qu’obtient-on exactement en sortie ?

Une courte chaîne de caractères, le blurhash, que vous stockez à côté de l’image. Décodée côté navigateur ou application, elle affiche un aperçu flou coloré pendant le chargement de la vraie photo.

Le blurhash remplace-t-il la vraie image ?

Non. C’est un aperçu de transition, volontairement flou et très léger. La photo nette se charge par-dessus dès qu’elle est disponible ; le blurhash ne fait que combler l’attente.

Mon image est-elle transmise pour le calcul ?

Non. La génération se fait dans votre navigateur : le fichier reste local et n’est ni envoyé ni conservé. Vous pouvez traiter des visuels non publiés sans les exposer.

Est-ce gratuit ?

Oui, sans limite dans le navigateur, car le calcul est local. Aucune inscription n’est demandée pour cet usage manuel.

Comment générer un blurhash à chaque import d’image ?

Passez par l’API pour l’intégrer à votre flux de publication. L’usage dans le navigateur reste gratuit ; l’appel automatisé via l’API est facturé à 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/blurhash

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/blurhash \
  -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/blurhash", {
  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/blurhash",
    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/blurhash", 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/blurhash", 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.blurhash",
  "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