Calculadora de carboidratos

Ela multiplica para alocar as calorias de carboidrato e divide pelo fator Atwater padrão de quatro kilocalorias por grama, gerando um carb_g diário claro para listas de compras, diários de treino ou painéis de coaching. Calorias ou percentuais não positivos são rejeitados como invalid_input porque uma fração de energia nula ou negativa não define uma meta em gramas. A ferramenta gratuita no dispositivo e a API compartilham o mesmo contrato; itens de API bem-sucedidos são cobrados a US$ 0,002 no saldo KIT e falhas de validação não são cobradas.

O que a calculadora mede e quais entradas você precisa

A ingestão diária de carboidratos em gramas é a quantidade de carboidrato digerível que corresponde à fração escolhida da energia diária total sob a convenção Atwater de energia metabolizável usada em rótulos de alimentos e em muitos textos de nutrição. A fórmula é simples e transparente: as calorias de carboidrato equivalem às calorias totais vezes o percentual de carboidrato dividido por cem; os gramas de carboidrato equivalem a essas calorias de carboidrato divididas por quatro, porque um grama de carboidrato contribui com quatro kilocalorias na escala Atwater geral. Percentuais acima de cem também falham na validação porque um percentual da energia total não pode exceder o todo. Envie calories como número finito positivo em kilocalorias por dia; os aliases total_calories, kcal, energy_kcal, calorie_intake e calorie_intake_kcal são aceitos para que produtos que já armazenam energia sob outra chave não precisem de camada de tradução. Envie carb_percent como percentual finito positivo da energia total proveniente de carboidrato, no máximo cem; os aliases carbohydrate_percent, carbs_percent, carb_pct, percent e pct mapeiam para o mesmo campo. O motor ecoa calories e carb_percent normalizados e devolve carb_calories_kcal, carb_g, kcal_per_gram fixo em quatro, unit em g/day, uma string formula para a ajuda da interface e method igual a atwater_carb_4kcal_g para que clientes ramifiquem sem cheirar formatos. Se qualquer campo estiver ausente, não for finito, for zero ou negativo, a requisição falha com invalid_input e não é cobrada. Entradas idênticas sempre geram o mesmo JSON porque o algoritmo nunca toca a rede, um modelo de linguagem, um relógio de parede ou um gerador aleatório — exatamente o contrato que automação e demos no estilo de exercício precisam.

Como ler os campos da resposta e armadilhas comuns

Não trate a saída como prescrição médica: pessoas com diabetes, doença renal, distúrbios de armazenamento de glicogênio ou dietas clínicas precisam de orientação profissional. Em caso de sucesso a resposta inclui calories e carb_percent como ecos limpos para que o cliente confirme o que foi calculado sem reanalisar formulários de texto livre. O número principal de planejamento é carb_g em gramas por dia: a quantidade de carboidrato que entregaria a fração energética pedida a quatro kilocalorias por grama. O campo carb_calories_kcal mostra a alocação energética intermediária, útil quando um painel já exibe colunas de calorias de proteína e gordura e precisa de uma terceira coluna coerente. kcal_per_gram é sempre quatro, unit é sempre g/day, formula reafirma carb_g igual a calories vezes carb_percent sobre cem sobre quatro, e method é sempre atwater_carb_4kcal_g para versionamento estável da rota Atwater de carboidrato. Use carb_g quando um planejador de refeições só precisa de um orçamento diário em gramas; use carb_calories_kcal ao desenhar gráficos de macros em unidades de energia em vez de massa. Ingestões calóricas extremamente altas acima do teto de segurança do isolate são rejeitadas para manter o trabalho do Worker limitado. Lembre-se de que álcool e polióis ficam fora deste endpoint; se o seu produto rastreia energia de etanol em separado, subtraia antes de chamar ou trate esta calculadora apenas como a fatia de carboidrato de um plano macro mais amplo.

Uso da API, preços, fluxos de coaching e limites práticos

Chame a calculadora gratuita de ingestão de carboidratos no navegador para verificações rápidas, educação do cliente, demos de aula e planejamento de lista de compras sem instalar uma planilha de nutrição. Prefira ingestões calóricas que já coincidam com a estimativa energética diária do seu produto — se você só conhece BMR ou TDEE, resolva isso primeiro e depois escolha um percentual de carboidrato adequado à meta (por exemplo mais alto em blocos de resistência de alto volume, moderado em manutenção equilibrada, mais baixo em experimentos low-carb deliberados). Mantenha expectativas educativas: esta é uma ferramenta de planejamento e letramento, não um dispositivo médico de diagnóstico, e usuários com necessidades clínicas atípicas devem seguir orientação profissional em vez de qualquer fórmula isolada. Envie um corpo JSON com calories e carb_percent obrigatórios (ou seus aliases). Use a API pré-paga quando um SaaS de bem-estar, um formulário de telemedicina, um pipeline de nutrição esportiva ou um app de rastreamento calórico precisarem de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Combine este endpoint com o seu banco de registro de alimentos: calcule aqui a meta em gramas e depois compare o carboidrato registrado com carb_g no cliente. Autores de SDK podem mapear carb_g e carb_calories_kcal em cartões de painel e colunas CSV rotuladas como carboidratos diários e calorias de carboidrato — os mesmos números que um coach escreve à mão ao aplicar percentual de calorias dividido por quatro no papel.