Calculateur d'apport en glucides

Il multiplie pour allouer les calories glucidiques, puis divise par le facteur Atwater standard de quatre kilocalories par gramme, pour un carb_g quotidien clair à placer près des listes de courses, carnets d'entraînement ou tableaux de coaching. Les calories ou pourcentages non positifs sont rejetés en invalid_input car une part d'énergie nulle ou négative ne définit pas une cible en grammes. L'outil gratuit sur l'appareil et l'API partagent le même contrat ; les items API réussis sont facturés à $0.002 sur le solde KIT et les échecs de validation ne sont pas débités.

Ce que mesure le calculateur et les entrées dont vous avez besoin

L'apport quotidien en glucides en grammes est la quantité de glucides digestibles qui correspond à la part choisie de l'énergie quotidienne totale selon la convention Atwater d'énergie métabolisable utilisée sur les étiquettes alimentaires et dans de nombreux manuels de nutrition. La formule est simple et transparente : les calories glucidiques égalent les calories totales multipliées par le pourcentage de glucides divisé par cent ; les grammes de glucides égalent ces calories glucidiques divisées par quatre, car un gramme de glucide apporte quatre kilocalories sur l'échelle Atwater générale. Les pourcentages supérieurs à cent échouent aussi à la validation car un pourcentage de l'énergie totale ne peut dépasser le tout. Envoyez calories comme nombre fini positif en kilocalories par jour ; les alias total_calories, kcal, energy_kcal, calorie_intake et calorie_intake_kcal sont acceptés afin que les produits qui stockent déjà l'énergie sous une autre clé n'aient pas besoin d'une couche de traduction. Envoyez carb_percent comme pourcentage fini positif de l'énergie totale issue des glucides, au plus cent ; les alias carbohydrate_percent, carbs_percent, carb_pct, percent et pct mappent vers le même champ. Le moteur renvoie l'écho normalisé de calories et carb_percent, puis carb_calories_kcal, carb_g, kcal_per_gram fixé à quatre, unit égal à g/day, une chaîne formula affichable dans l'aide de l'interface, et method égal à atwater_carb_4kcal_g pour que les clients branchent sans renifler les formes. Si un champ est absent, non fini, nul ou négatif, la requête échoue avec invalid_input et n'est pas facturée. Des entrées identiques produisent toujours le même JSON car l'algorithme ne touche jamais le réseau, un modèle de langage, une horloge murale ni un générateur aléatoire — exactement le contrat dont ont besoin l'automatisation et les démonstrations de type exercice.

Lire les champs de réponse et les pièges fréquents

Ne traitez pas la sortie comme une prescription médicale : les personnes diabétiques, atteintes de maladie rénale, de troubles du stockage du glycogène ou sous régime clinique ont besoin d'un avis professionnel. En cas de succès la réponse inclut calories et carb_percent comme échos nettoyés pour que les clients confirment ce qui a été calculé sans réanalyser des formulaires en texte libre. Le chiffre principal de planification est carb_g en grammes par jour : la quantité de glucides qui livrerait la part d'énergie demandée à quatre kilocalories par gramme. Le champ carb_calories_kcal montre l'allocation énergétique intermédiaire, utile lorsqu'un tableau de bord affiche déjà des colonnes de calories protéiques et lipidiques et a besoin d'une troisième colonne cohérente. kcal_per_gram vaut toujours quatre, unit vaut toujours g/day, formula reformule carb_g égal à calories multiplié par carb_percent sur cent sur quatre, et method vaut toujours atwater_carb_4kcal_g pour un versionnage stable de la voie Atwater glucides. Utilisez carb_g lorsqu'un planificateur de repas n'a besoin que d'un budget quotidien en grammes ; utilisez carb_calories_kcal lorsque vous dessinez des camemberts de macros en unités d'énergie plutôt qu'en masse. Les apports caloriques extrêmement élevés au-dessus du plafond de sécurité de l'isolate sont rejetés pour borner le travail du Worker. Souvenez-vous que l'alcool et les polyols sont hors de cet endpoint ; si votre produit suit séparément l'énergie de l'éthanol, soustrayez-la avant l'appel ou traitez ce calculateur uniquement comme la part glucides d'un plan macro plus large.

Usage de l'API, tarification, flux de coaching et limites pratiques

Appelez le calculateur gratuit d'apport en glucides dans le navigateur pour des vérifications rapides, l'éducation client, des démos de cours et la planification de listes de courses sans installer de tableur nutritionnel. Préférez des apports caloriques déjà alignés sur l'estimation énergétique quotidienne de votre produit — si vous ne connaissez que le BMR ou le TDEE, résolvez-les d'abord, puis choisissez un pourcentage de glucides adapté à l'objectif (par exemple plus élevé pour des blocs d'endurance à haut volume, modéré pour un maintien équilibré, plus bas pour des expériences low-carb délibérées). Gardez des attentes éducatives : c'est un outil de planification et de littératie, non un dispositif médical de diagnostic, et les utilisateurs aux besoins cliniques atypiques doivent suivre un avis professionnel plutôt qu'une seule formule. Envoyez un corps JSON avec calories et carb_percent obligatoires (ou leurs alias). Utilisez l'API prépayée lorsqu'un SaaS bien-être, un formulaire de télésanté, un pipeline de nutrition sportive ou une application de suivi calorique ont besoin d'un contrat stable sous solde KIT à $0.002 par item réussi ; les échecs de validation ne consomment jamais le solde après le rejet du moteur. Associez cet endpoint à votre base de journal alimentaire : calculez ici la cible en grammes, puis comparez les glucides enregistrés à carb_g côté client. Les auteurs de SDK peuvent mapper carb_g et carb_calories_kcal vers des cartes de tableau de bord et des colonnes CSV étiquetées glucides quotidiens et calories glucidiques — les mêmes chiffres qu'un coach écrit à la main en appliquant le pourcentage de calories divisé par quatre sur papier.