ForHosting KIT · Santé et sport

Calculateur de calories par macronutriments (Atwater)

Convertit protéines, glucides, lipides et alcool en calories avec les facteurs d'Atwater : 25 g de protéines, 40 g de glucides et 12 g de lipides font 368 kcal. Vous voyez la part de chaque macronutriment et le total en kilojoules. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Protéines (g): 25
Glucides (g): 40
Fat g: 12
Alcool (g): 0

Vous obtenez

Protéines (kcal): 100 kcal
Glucides (kcal): 160
Lipides (kcal): 108
Calories de l'alcool (kcal): 0

Les étiquettes nutritionnelles, les journaux de repas et les pipelines de nutrition ont besoin d'une réponse transparente à une seule question : compte tenu des grammes de protéines, de glucides, de lipides et d'alcool d'une portion ou d'une journée, quelle énergie métabolisable cela fournit-il ? Ce calculateur de calories à partir des macronutriments applique les facteurs généraux d'Atwater—quatre kilocalories par gramme de protéines, quatre de glucides, neuf de lipides et sept d'alcool—et renvoie la contribution de chaque macronutriment ainsi que l'énergie totale en kilocalories et kilojoules. Utilisez-le pour vérifier le calcul d'étiquettes, convertir des exports de trackers en totaux énergétiques ou auditer des plans de repas sans embarquer une formule de tableur dans chaque client.

Facteurs d'Atwater et sens de l'énergie alimentaire totale

Le système général d'Atwater est la manière conventionnelle dont la science de la nutrition et l'étiquetage alimentaire convertissent la masse des macronutriments en énergie métabolisable. Les protéines et les glucides disponibles reçoivent chacun quatre kilocalories par gramme, les lipides neuf et l'éthanol sept. Ces facteurs intègrent déjà les pertes digestives moyennes et les ajustements de chaleur de combustion utilisés en diététique ; ce ne sont pas les valeurs brutes de bombe calorimétrique pour chaque aliment, mais la valeur par défaut standard lorsque seuls les grammes sont connus.

L'énergie totale est la somme des quatre produits : quatre fois les grammes de protéines plus quatre fois ceux de glucides plus neuf fois ceux de lipides plus sept fois ceux d'alcool. Cette capacité n'ajuste pas les fractions de fibres alimentaires, les polyols à facteurs alternatifs ni la digestibilité incomplète des protéines—ces raffinements exigent des tables de composition et sortent d'une transformation pure grammes vers énergie.

Vous obtenez un total reproductible de type étiquette, aligné sur la façon dont la plupart des applications grand public et de nombreux exemples réglementaires enseignent les calories à partir des macros.

Qui recalcule les calories des macros, et pourquoi

Les plateformes de coaching diététique stockent déjà des cibles en grammes et des journaux d'assiettes ; multiplier par les facteurs d'Atwater côté serveur maintient chaque client et chaque rapport sur une seule définition de l'énergie alimentaire au lieu de cellules de tableur divergentes. Les coordinateurs de recherche convertissent des carnets d'aliments pesés en énergie journalière sans licences de bases de composition lorsque seuls les macros ont été enregistrés.

Les outils de conformité d'étiquettes recalculent la ligne d'énergie à partir des protéines, glucides, lipides et alcool déclarés, de sorte qu'un changement d'emballage se revérifie en quelques secondes. Les équipes meal-kit et de restauration collective additionnent les macros des composants en énergie de plat pour menus et achats. Une validation échouée ne consomme pas le solde.

Cas d’usage

Vérifier l'énergie d'étiquette à partir des macros déclarés

Recalculez la ligne de calories à partir des grammes de protéines, glucides, lipides et alcool avec les facteurs Atwater standards avant publication d'emballage ou de menu.

Questions fréquentes

Quels facteurs d'Atwater ce calculateur utilise-t-il ?

Facteurs généraux : 4 kcal/g de protéines, 4 kcal/g de glucides, 9 kcal/g de lipides et 7 kcal/g d'alcool. La réponse inclut un objet factors pour afficher le tableau à côté du total.

L'alcool est-il obligatoire si l'aliment n'en contient pas ?

Les quatre champs en grammes sont obligatoires pour qu'une entrée manquante ne soit jamais traitée comme zéro par accident.

Pourquoi le total diffère-t-il des calories de l'étiquette ?

Parce que le calculateur applique les facteurs généraux d'Atwater. Il n'ajuste ni les fractions de fibres, ni les polyols aux facteurs propres, ni la digestibilité incomplète des protéines : ces affinements exigent des tables de composition des aliments.

Quel macronutriment apporte le plus de calories à mon repas ?

Le calculateur affiche la part de chacun séparément. Avec 25 g de protéines, 40 g de glucides et 12 g de lipides, on obtient 100, 160 et 108 kcal : à 9 kcal par gramme, les lipides égalent presque les glucides avec moins d'un tiers des grammes.

Comment convertir le total de kilocalories en kilojoules ?

Inutile de le faire à la main : le résultat donne les deux. Les kilojoules valent les kilocalories multipliées par 4,184, donc 368 kcal correspondent à 1539,712 kJ.

Outils associés

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/health/energy-from-macros

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/health/energy-from-macros \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"protein_g":25,"carbohydrate_g":40,"fat_g":12,"alcohol_g":0}'

const res = await fetch("https://api.kit.forhosting.com/health/energy-from-macros", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "protein_g": 25,
    "carbohydrate_g": 40,
    "fat_g": 12,
    "alcohol_g": 0
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/health/energy-from-macros",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "protein_g": 25,
    "carbohydrate_g": 40,
    "fat_g": 12,
    "alcohol_g": 0
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/energy-from-macros", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"protein_g":25,"carbohydrate_g":40,"fat_g":12,"alcohol_g":0}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"protein_g":25,"carbohydrate_g":40,"fat_g":12,"alcohol_g":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/energy-from-macros", 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

{
  "protein_g": 25,
  "carbohydrate_g": 40,
  "fat_g": 12,
  "alcohol_g": 0
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "health.energy_from_macros",
  "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.

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.

Notes techniques

Contrat d'entrée, champs de réponse et erreurs de validation

Les grammes négatifs sont rejetés car la masse ne peut pas être négative dans ce contrat. L'absence de l'un des quatre champs échoue aussi avec un message clair de champ manquant et n'est pas facturée. Exemple : vingt-cinq grammes de protéines, quarante de glucides, douze de lipides et zéro d'alcool donnent cent kcal de protéines, cent soixante de glucides, cent huit de lipides, zéro d'alcool et trois cent soixante-huit kilocalories au total. Envoyez en POST un objet JSON avec quatre nombres finis non négatifs obligatoires : protein_g, carbohydrate_g, fat_g et alcohol_g, mesurés en grammes. Des alias courts sont acceptés pour brancher des formulaires existants sans renommage : protein, protein_grams ou p pour les protéines ; carbohydrate, carbs, carb_g, carbs_g ou c pour les glucides ; fat, lipid_g, lipids ou f pour les lipides ; alcohol, ethanol_g, ethanol ou a pour l'alcool. Les valeurs peuvent arriver en nombres JSON ou en chaînes numériques ; chaînes vides, booléens, objets, NaN et Infinity échouent avec invalid_input en nommant le champ. En cas de succès la réponse renvoie les grammes nettoyés, protein_kcal, carbohydrate_kcal, fat_kcal et alcohol_kcal comme contributions par macro, total_kcal comme leur somme, total_kj comme total_kcal multiplié par 4.184 (conversion thermochimique), un objet factors réaffirmant quatre, quatre, neuf et sept, une courte chaîne formula et unit en kcal pour la grandeur énergétique principale. Associez la vérification gratuite dans le navigateur à l'automatisation API lorsque vous avez besoin des mêmes chiffres dans un journal backend.

Où une API de calories à partir des macros apporte de la valeur

Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002, sans jetons de modèle ni réseau sortant.

Cas d'intégration

Convertir les grammes du tracker en énergie journalière

Additionnez les grammes de macros enregistrés pour un jour ou une portion et obtenez total_kcal et total_kj avec un contrat API déterministe pour rapports et tableaux de bord.

Auditer plans de coaching et carnets de recherche

Appliquez une définition partagée 4/4/9/7 aux plans clients ou aux carnets d'étude afin que les totaux énergétiques restent comparables et testables par golden tests.

Questions techniques

Comment calculer les calories à partir des grammes de macronutriments ?

Envoyez protein_g, carbohydrate_g, fat_g et alcohol_g finis et non négatifs. total_kcal vaut 4·P + 4·C + 9·F + 7·A ; total_kj vaut total_kcal × 4.184.

Pourquoi ma requête a-t-elle été rejetée ?

Chaque champ doit être un nombre fini non négatif (nombre JSON ou chaîne numérique). Valeurs manquantes, non numériques, infinies ou négatives renvoient invalid_input et ne sont pas facturées.

Combien coûte le calculateur de calories à partir des macronutriments ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement