ForHosting KIT · Strumenti per sviluppatori

Calorie di una ricetta: totale e per porzione

Questo calcolatore trasforma un elenco pratico di ingredienti in due valori utili: le calorie dell’intera ricetta e quelle di ogni porzione.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca la quantità di ciascun ingrediente, le calorie contenute in un’unità corrispondente e il numero di porzioni ottenute. Lo strumento moltiplica ogni quantità per le calorie unitarie, somma i risultati e divide il totale per il numero di porzioni. Restituisce inoltre un dettaglio per ingrediente, così Lei può verificare i passaggi anziché affidarsi a una stima priva di spiegazione.

Prepari valori compatibili per gli ingredienti

Parta dai dati nutrizionali di ogni ingrediente e verifichi che l’unità corrisponda alla quantità che intende inserire. Se l’etichetta indica 95 calorie per cucchiaio, una quantità pari a due significa due cucchiai e contribuisce con 190 calorie. Se la ricetta usa grammi, ma la fonte riporta le calorie per 100 grammi, inserisca il numero di unità da 100 grammi oppure converta prima il valore in calorie per grammo. Il calcolatore non presume unità, dimensioni delle porzioni, resa edibile o densità, perché tali ipotesi cambiano molto tra alimenti e cucine. Ogni riga richiede un nome chiaro, una quantità pari o superiore a zero e calorie unitarie non negative. Lo zero può indicare un ingrediente privo di energia o momentaneamente escluso; i valori negativi vengono rifiutati. La corrispondenza tra l’unità della fonte e quella inserita è il requisito più importante per ottenere un totale significativo. Quando serve precisione, consulti la confezione, una banca dati nutrizionale affidabile o la Sua scheda di formulazione.

Comprenda il calcolo e il risultato

Per ogni riga, il calcolatore moltiplica la quantità per le calorie per unità. Poi somma tutti i contributi per ricavare le calorie totali della ricetta e divide il totale per le porzioni. Per esempio, un ingrediente con quantità 1.5 e 80 calorie per unità contribuisce con 120 calorie. Il dettaglio conserva il nome normalizzato, la quantità, il valore unitario e le calorie calcolate di ogni ingrediente, facilitando l’individuazione di errori di trascrizione. I risultati sono arrotondati a sei decimali per produrre un output stabile e ripetibile, mentre il totale viene accumulato prima dell’arrotondamento finale. Il numero di porzioni può essere intero o decimale positivo, quindi sono ammesse rese come 2.5 porzioni, ma non può essere zero o negativo. L’output riporta anche il conteggio degli ingredienti e delle porzioni. Un flusso automatico può così verificare di avere elaborato la ricetta prevista senza dipendere dall’ordine di visualizzazione o da presupposti nascosti.

Utilizzi la stima in modo responsabile

Consideri il risultato una stima aritmetica la cui qualità dipende dai valori forniti. Le etichette nutrizionali applicano arrotondamenti, gli ingredienti naturali variano e la cottura può modificare l’acqua senza cambiare necessariamente l’energia del lotto. L’olio rimasto nella padella, una marinata eliminata, gli scarti, l’evaporazione e porzioni non uniformi possono creare differenze tra calorie calcolate e consumate. Per pianificare i pasti, usi la resa realmente suddivisa: se prevedeva sei porzioni ma riempie cinque contenitori, inserisca cinque. Quando la costanza è importante, pesi il piatto finito, definisca una porzione in base al peso e determini quante porzioni contiene il lotto. L’API esegue lo stesso calcolo deterministico della versione nel browser, senza consultare la rete e senza sostituire in silenzio dati nutrizionali mancanti. È quindi adatta a fogli di ricette, strumenti per menu, sistemi di preparazione pasti e test ripetibili. Non offre consulenza medica e non sostituisce un professionista qualificato per nutrizione clinica, allergie o terapie.

Casi d'uso

Pianificare porzioni per pasti preparati

Calcoli il totale del lotto e lo divida per il numero esatto di contenitori che prepara.

Confrontare varianti della ricetta

Modifichi una quantità o un valore calorico e osservi l’effetto sulla ricetta e su ogni porzione.

Aggiungere stime a un ricettario digitale

Usi risultati deterministici e dettagli verificabili in menu, fogli di calcolo o applicazioni culinarie.

Domande frequenti

Quanto costa un calcolo tramite API?

Ogni calcolo tramite API costa $0.002. Il calcolatore nel browser viene eseguito localmente e gratuitamente.

Che cosa significa calorie per unità?

Sono le calorie di un’unità coerente con la quantità, come un grammo, un cucchiaio, una tazza o una confezione.

Il numero di porzioni può essere decimale?

Sì. È accettato qualsiasi numero finito positivo, anche per rese parziali o definite in base al peso.

Perché zero e valori negativi vengono rifiutati?

Il calcolo per porzione richiede la divisione per una quantità fisicamente valida, che deve essere maggiore di zero.

Lo strumento cerca informazioni nutrizionali?

No. Esegue calcoli deterministici sulle quantità e calorie fornite da Lei, senza richieste di rete.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/cook/calorie-count-recipe

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/cook/calorie-count-recipe \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ingredients":[{"name":"Rolled oats","quantity":2,"calories_per_unit":150},{"name":"Banana","quantity":1.5,"calories_per_unit":105},{"name":"Peanut butter","quantity":2,"calories_per_unit":95}],"servings":5}'

const res = await fetch("https://api.kit.forhosting.com/cook/calorie-count-recipe", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ingredients": [
      {
        "name": "Rolled oats",
        "quantity": 2,
        "calories_per_unit": 150
      },
      {
        "name": "Banana",
        "quantity": 1.5,
        "calories_per_unit": 105
      },
      {
        "name": "Peanut butter",
        "quantity": 2,
        "calories_per_unit": 95
      }
    ],
    "servings": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/cook/calorie-count-recipe",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ingredients": [
        {
            "name": "Rolled oats",
            "quantity": 2,
            "calories_per_unit": 150
        },
        {
            "name": "Banana",
            "quantity": 1.5,
            "calories_per_unit": 105
        },
        {
            "name": "Peanut butter",
            "quantity": 2,
            "calories_per_unit": 95
        }
    ],
    "servings": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/calorie-count-recipe", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ingredients":[{"name":"Rolled oats","quantity":2,"calories_per_unit":150},{"name":"Banana","quantity":1.5,"calories_per_unit":105},{"name":"Peanut butter","quantity":2,"calories_per_unit":95}],"servings":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ingredients":[{"name":"Rolled oats","quantity":2,"calories_per_unit":150},{"name":"Banana","quantity":1.5,"calories_per_unit":105},{"name":"Peanut butter","quantity":2,"calories_per_unit":95}],"servings":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/calorie-count-recipe", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "ingredients": [
    {
      "name": "Rolled oats",
      "quantity": 2,
      "calories_per_unit": 150
    },
    {
      "name": "Banana",
      "quantity": 1.5,
      "calories_per_unit": 105
    },
    {
      "name": "Peanut butter",
      "quantity": 2,
      "calories_per_unit": 95
    }
  ],
  "servings": 5
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "cook.calorie_count_recipe",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →