ForHosting KIT · Outils pour développeurs

Calculez les macros en grammes selon calories et pourcentages

Ce calculateur de répartition des macronutriments transforme un objectif calorique quotidien et trois pourcentages en cibles pratiques de protéines, glucides et lipides exprimées en grammes.

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

Il applique les facteurs énergétiques usuels : quatre calories par gramme de protéines, quatre par gramme de glucides et neuf par gramme de lipides. Chaque valeur est contrôlée et toute répartition dont le total n’atteint pas 100 est refusée. Il convient ainsi aux programmes nutritionnels, au coaching, aux feuilles de préparation des repas et aux applications sportives qui exigent un résultat clair et reproductible sans correction silencieuse du ratio.

Saisissez un objectif calorique complet

Commencez par le nombre total de calories prévu pour une journée, puis indiquez la part attribuée aux protéines, aux glucides et aux lipides. Chaque part correspond à un pourcentage de l’énergie, et non au poids des aliments ni à une quantité en grammes. Un objectif de 30 pour cent de protéines signifie, par exemple, que cette fraction du budget calorique quotidien provient des protéines. Les quatre valeurs sont obligatoires afin que le calcul reste explicite et reproductible. Les calories doivent être un nombre fini strictement supérieur à zéro. Chaque pourcentage doit être un nombre fini compris entre zéro et 100 inclus : un programme peut donc attribuer volontairement zéro à un macronutriment, mais les parts négatives ou impossibles sont refusées. Saisissez les nombres sans symbole de pourcentage ni unité. La réponse rappelle les calories acceptées et présente la répartition complète avec les grammes calculés, ce qui permet de conserver les hypothèses exactes du résultat. Cet outil ne détermine pas l’objectif ou le ratio adapté à une personne ; il exécute uniquement le calcul à partir des cibles que vous avez choisies.

Comprenez la conversion des calories en grammes

Le calcul répartit d’abord les calories quotidiennes entre les trois macronutriments. Il multiplie le total par chaque pourcentage, puis divise par 100. L’énergie attribuée est ensuite convertie en grammes avec quatre kilocalories par gramme de protéines, quatre par gramme de glucides et neuf par gramme de lipides. Prenons 2,000 calories réparties en 30 pour cent de protéines, 40 pour cent de glucides et 30 pour cent de lipides. Les protéines reçoivent 600 calories, soit 150 grammes. Les glucides reçoivent 800 calories, soit 200 grammes. Les lipides reçoivent 600 calories, soit environ 66.666667 grammes, car ils fournissent davantage d’énergie par gramme. Les résultats sont arrondis à six décimales au maximum pour supprimer les artefacts de virgule flottante tout en conservant une précision utile. L’algorithme n’utilise ni réseau, ni hasard, ni état enregistré, ni heure courante. Une entrée JSON identique produit donc toujours la même sortie JSON, ce qui facilite l’automatisation, les tests, les feuilles de calcul et les services exigeant des valeurs stables.

Corrigez le total des pourcentages avant le calcul

Les pourcentages de protéines, glucides et lipides doivent totaliser 100, car ils décrivent ensemble l’intégralité du budget calorique. Un total de 95 laisse cinq pour cent sans affectation ; un total de 110 attribue davantage d’énergie que l’objectif annoncé. Au lieu de normaliser ou de modifier discrètement les valeurs, la capacité renvoie une erreur d’entrée et précise que leur somme doit être égale à 100. Ce comportement strict met en évidence les fautes de saisie et évite un résultat apparemment fiable fondé sur des hypothèses que vous n’avez jamais validées. Une tolérance infime sert uniquement à gérer la représentation habituelle des nombres flottants, jamais à accepter un ratio réellement incomplet. En cas d’erreur, vérifiez les trois pourcentages plutôt que les calories, puisque cette règle concerne la répartition. Une réponse valide regroupe les parts originales et les grammes obtenus afin que les systèmes suivants puissent les afficher ensemble. Considérez ces valeurs comme des objectifs de planification, non comme des mesures cliniques : étiquettes, recettes, arrondis, fibres, alcool et besoins personnels relèvent du processus nutritionnel environnant.

Préparer un objectif alimentaire quotidien

Convertissez un objectif calorique et un ratio établis en grammes pouvant orienter les recettes et les portions.

Valider les calculs d’un programme

Vérifiez que la répartition proposée est complète avant d’enregistrer les cibles calculées pour une personne accompagnée.

Alimenter une application sportive

Produisez des grammes déterministes sans dupliquer les règles de conversion entre clients et services.

Les pourcentages doivent-ils totaliser 100 ?

Oui. Le calcul renvoie une erreur d’entrée si les protéines, les glucides et les lipides ne totalisent pas 100.

Comment les calories deviennent-elles des grammes ?

Les calories des protéines et des glucides sont divisées par quatre ; celles des lipides sont divisées par neuf.

Un macronutriment peut-il être fixé à zéro pour cent ?

Oui. Chaque part peut aller de zéro à 100, à condition que la somme des trois reste égale à 100.

Ce calculateur recommande-t-il un ratio ?

Non. Il calcule les grammes d’après vos valeurs et ne fournit aucun conseil médical ou diététique.

Combien coûte une requête API ?

Le tarif de base publié est de $0.002 par requête. L’expérience dans le navigateur peut employer le même calcul déterministe.

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/calc2/macro-split-calculate

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/calc2/macro-split-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"calories":2000,"protein_percent":30,"carb_percent":40,"fat_percent":30}'
{
  "calories": 2000,
  "protein_percent": 30,
  "carb_percent": 40,
  "fat_percent": 30
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.macro_split_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.

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 →