ForHosting KIT · Outils pour développeurs

Calculer les calories des macros

Ce calculateur inversé convertit les grammes indiqués dans un programme alimentaire, une recette, un repas ou une étiquette en un total calorique.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez les protéines, les glucides et les lipides : il applique les facteurs usuels de 4 kilocalories par gramme de protéines, 4 par gramme de glucides et 9 par gramme de lipides. Le résultat détaille l’apport de chaque macronutriment ainsi que leur somme, afin que vous puissiez vérifier et réutiliser facilement le calcul.

Calculez les calories lorsque les quantités de macros sont connues

Les objectifs nutritionnels sont souvent exprimés en grammes plutôt que sous la forme d’un total calorique unique. Pour les convertir, saisissez les quantités de protéines, de glucides et de lipides telles qu’elles figurent dans le programme ou le relevé. Le calculateur multiplie les grammes de protéines par 4, ceux de glucides par 4 et ceux de lipides par 9, puis additionne les trois contributions. Cette méthode convient lorsqu’un professionnel vous communique des objectifs quotidiens de macronutriments, lorsqu’une analyse de recette indique les nutriments sans préciser l’énergie ou lorsqu’un journal alimentaire doit être contrôlé. Les trois valeurs sont obligatoires ; indiquez zéro pour un macronutriment absent. Les nombres décimaux sont acceptés : une quantité telle que 12.5 grammes ne doit donc pas être arrondie au préalable. Les valeurs négatives sont refusées, car une quantité physique de macronutriment ne peut pas être négative. La réponse reprend les grammes acceptés et affiche chaque contribution calorique avec le total, ce qui vous permet d’identifier clairement l’origine de l’énergie.

Comprenez les facteurs caloriques usuels 4/4/9

Le calcul repose sur les facteurs énergétiques conventionnels des macronutriments : les protéines fournissent 4 kilocalories par gramme, les glucides 4 et les lipides 9. Ces coefficients expliquent pourquoi deux aliments de même poids peuvent présenter des valeurs caloriques très différentes. Les lipides sont plus denses en énergie ; ajouter un gramme de lipides modifie donc davantage le total qu’ajouter un gramme de protéines ou de glucides. Le résultat isole les calories issues des protéines, des glucides et des lipides avant de les additionner, afin que vous puissiez contrôler la formule sans vous fier à un chiffre inexpliqué. Il s’agit d’une estimation arithmétique fondée exclusivement sur les trois macronutriments fournis. Elle ne déduit ni nutriments manquants, ni portions, ni poids d’ingrédients, et n’applique pas de coefficient propre à un aliment. Un léger écart avec une étiquette peut provenir des arrondis, du traitement des fibres ou polyols, des acides organiques, de l’alcool ou des règles locales. Considérez ce résultat comme un total transparent fondé sur les macros, et non comme un substitut à toute méthode réglementaire d’étiquetage.

Exploitez le résultat pour les programmes, recettes et contrôles

Le calcul inversé est particulièrement utile lorsque les grammes constituent la donnée de référence. Pour un programme quotidien, saisissez les objectifs afin d’estimer l’énergie correspondant à cette répartition des macros. Pour une recette, additionnez d’abord les protéines, les glucides et les lipides de tous les ingrédients, puis calculez les calories de la préparation entière ; divisez ensuite le total si vous souhaitez une valeur par portion. Dans un traitement de données nutritionnelles, transmettez les trois champs de chaque enregistrement à l’API et comparez le résultat à la valeur calorique enregistrée. Un écart ne signifie pas automatiquement qu’une valeur est fausse : les étiquettes peuvent arrondir chaque nutriment séparément ou tenir compte d’éléments absents de cette formule. Un écart important doit plutôt vous inviter à examiner la source et ses hypothèses. Conservez les décimales disponibles, car des arrondis précoces sur chaque ingrédient peuvent s’accumuler. L’opération est déterministe, sans réseau, hasard ni heure système : une entrée identique produit toujours la même sortie. Vous pouvez l’utiliser dans le navigateur ou automatiser chaque requête pour $0.002.

Vérifier un objectif quotidien de macros

Convertissez les objectifs en grammes de protéines, glucides et lipides donnés par un professionnel en calories totales du programme.

Estimer les calories d’une recette

Calculez l’énergie d’une recette après avoir totalisé ses trois macronutriments, puis utilisez le total de la préparation pour les portions.

Auditer des données nutritionnelles

Comparez une valeur calorique enregistrée à un total 4/4/9 transparent afin de repérer les fiches à examiner.

Quelle formule le calculateur utilise-t-il ?

Il calcule grammes de protéines × 4 + grammes de glucides × 4 + grammes de lipides × 9. Le résultat est exprimé en kilocalories, couramment appelées calories sur les étiquettes.

Pourquoi le résultat peut-il différer d’une étiquette ?

Les étiquettes peuvent appliquer des arrondis autorisés ou traiter autrement les fibres, polyols, alcools, acides organiques et autres composants. Le calculateur utilise uniquement les grammes fournis pour les trois macros.

Puis-je saisir des quantités décimales ?

Oui. Chaque champ accepte tout nombre fini positif ou nul, y compris une valeur décimale. Conserver la précision disponible donne généralement un meilleur total qu’un arrondi préalable.

Un macronutriment peut-il valoir zéro ?

Oui. Saisissez zéro lorsqu’un aliment, une recette ou un programme ne contient pas ce macronutriment. Les trois champs doivent néanmoins être renseignés pour rendre le calcul explicite.

Que se passe-t-il si je saisis une valeur négative ?

La requête renvoie une erreur d’entrée non valide précisant que les grammes ne peuvent pas être négatifs. Une quantité négative de macronutriment n’a pas de sens physique ici.

Combien coûte un calcul par l’API ?

Chaque requête à l’API coûte $0.002. Vous pouvez également exécuter gratuitement le même calcul déterministe dans votre navigateur sur cette page.

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.

POSThttps://api.kit.forhosting.com/calc3/calories-to-macros-reverse

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é.

curl -X POST https://api.kit.forhosting.com/calc3/calories-to-macros-reverse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"protein_g":150,"carbohydrates_g":250,"fat_g":70}'
{
  "protein_g": 150,
  "carbohydrates_g": 250,
  "fat_g": 70
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc3.calories_to_macros_reverse",
  "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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →