Calculateur de ratio café-eau
Une préparation fiable commence par un ratio café-eau reproductible. Ce calculateur accepte un ratio tel que 1:16 et soit la quantité d’eau que vous prévoyez d’utiliser, soit la masse de café moulu déjà pesée.
Lancer gratuitement
Il calcule immédiatement la quantité manquante dans la même unité. Utilisez-le pour un café filtre, une préparation en volume, une cafetière à piston ou la mise à l’échelle d’une recette, sans formule supplémentaire. Le calcul est déterministe et transparent, et l’API est disponible pour $0.002 par requête.
Interprétez le ratio comme café par rapport à l’eau
Un ratio d’extraction noté 1:16 signifie une part égale de café moulu pour seize parts égales d’eau. Les deux valeurs forment une proportion et peuvent donc être exprimées en grammes, en onces ou dans toute autre unité cohérente. Si vous indiquez 480 grammes d’eau avec un ratio de 1:16, le calculateur divise 480 par seize puis multiplie par un, soit 30 grammes de café. Un ratio ne prescrit pas une méthode et ne garantit pas un goût précis ; il fournit un point de départ maîtrisé et reproductible. Un nombre plus faible côté eau, comme 1:14, emploie davantage de café pour la même eau et donne généralement un résultat plus corsé. Un nombre plus élevé, comme 1:18, en emploie moins et produit souvent une tasse plus légère. Conservez toujours la même unité pour les deux quantités lors d’un calcul en masse. Le champ d’unité étiquette le résultat sans effectuer de conversion, ce qui empêche un mélange accidentel de grammes et d’onces de sembler valide.
Effectuez le calcul dans les deux sens
Choisissez le sens qui correspond à la quantité déjà fixée dans votre préparation. Si vous connaissez la capacité de la cafetière ou de la bouilloire, renseignez water_amount et omettez grounds_amount. Le calculateur multiplie l’eau par la valeur côté café, puis divise par la valeur côté eau. Si vous avez déjà pesé les grains ou souhaitez terminer un paquet, renseignez grounds_amount et omettez water_amount. Le calcul inverse multiplie le café par la valeur côté eau et divise par la valeur côté café. Une seule quantité doit être fournie : deux valeurs pourraient contredire le ratio demandé, tandis qu’aucune valeur ne donnerait pas d’échelle à la recette. La réponse présente les deux composantes du ratio, les quantités finales, l’unité commune et la valeur calculée. L’arrondi n’intervient qu’à dix décimales afin d’éliminer les artefacts numériques insignifiants tout en conservant une précision largement suffisante. La résolution de votre balance détermine ensuite l’arrondi physique pertinent.
Ajustez une recette tout en restant reproductible
Partez du ratio conseillé pour votre café ou votre méthode, calculez les quantités, puis notez le ratio avec la mouture, la température de l’eau, la durée de contact et vos observations. Si la tasse vous paraît trop légère ou trop corsée, modifiez volontairement une seule variable. Passer de 1:16 à 1:15 augmente la quantité de café par rapport à l’eau, alors que passer à 1:17 la diminue. Le calculateur isole ce changement en fournissant la quantité correspondante sans toucher au reste de la recette. Il facilite aussi la mise à l’échelle : saisissez davantage d’eau pour une grande préparation ou moins de café pour une tasse, et la proportion reste identique. Le café absorbe et retient une partie de l’eau ; le volume servi sera donc inférieur à la quantité initiale. Cet outil calcule les ingrédients, pas le volume final en tasse. Dans un processus automatisé, chaque requête API coûte $0.002, ce qui permet d’intégrer des recettes cohérentes à un journal, une feuille de travail ou une application de balance connectée.
Cas d’usage
Prévoir un volume adapté à la cafetière
Indiquez la capacité en eau et le ratio visé pour obtenir la quantité de café nécessaire à toute la préparation.
Utiliser une dose déjà pesée
Saisissez le café pesé afin de calculer l’eau correspondante sans modifier l’intensité prévue.
Redimensionner une recette enregistrée
Conservez le ratio initial lorsque vous augmentez ou réduisez une recette pour un autre nombre de portions.
Questions fréquentes
Que signifie un ratio de café de 1:16 ?
Il correspond à une part de café moulu pour seize parts d’eau, mesurées dans la même unité.
Puis-je calculer l’eau à partir du café ?
Oui. Renseignez grounds_amount et omettez water_amount ; la réponse fournit la quantité d’eau correspondante.
Puis-je calculer le café à partir de l’eau ?
Oui. Renseignez water_amount et omettez grounds_amount ; la réponse fournit le café nécessaire.
Le calculateur convertit-il les grammes en onces ?
Non. L’unité sert d’étiquette et les deux quantités doivent employer la même mesure. Convertissez-les avant le calcul si nécessaire.
Que se passe-t-il si le ratio est nul ou négatif ?
La requête est refusée, car les deux côtés du ratio café-eau doivent être strictement positifs.
Combien coûte une requête API ?
Chaque requête API coûte $0.002. Le calculateur peut fonctionner gratuitement et localement dans le navigateur.
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
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/cook/coffee-ratio-calculate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ratio":"1:16","water_amount":500}'const res = await fetch("https://api.kit.forhosting.com/cook/coffee-ratio-calculate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "1:16",
"water_amount": 500
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/cook/coffee-ratio-calculate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "1:16",
"water_amount": 500
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/coffee-ratio-calculate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"1:16","water_amount":500}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"1:16","water_amount":500}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/coffee-ratio-calculate", 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
{
"ratio": "1:16",
"water_amount": 500
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "cook.coffee_ratio_calculate",
"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
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
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. |