Calculadora de carbohidratos

Las multiplica para asignar las calorías de carbohidratos y divide por el factor Atwater estándar de cuatro kilocalorías por gramo, obteniendo un carb_g diario claro para listas de la compra, registros de entrenamiento o paneles de coaching. Las calorías o el porcentaje no positivos se rechazan como invalid_input porque una fracción de energía nula o negativa no define un objetivo en gramos. La herramienta gratuita en el dispositivo y la API comparten el mismo contrato; los ítems correctos de API se facturan a $0.002 contra el saldo KIT y los fallos de validación no se cobran.

Qué mide la calculadora y qué entradas necesita usted

La ingesta diaria de carbohidratos en gramos es la cantidad de carbohidrato digestible que corresponde a la fracción elegida de la energía diaria total según el convenio Atwater de energía metabolizable usado en etiquetas de alimentos y en muchos textos de nutrición. La fórmula es simple y transparente: las calorías de carbohidratos equivalen a las calorías totales por el porcentaje de carbohidratos entre cien; los gramos de carbohidratos equivalen a esas calorías de carbohidratos entre cuatro, porque un gramo de carbohidrato aporta cuatro kilocalorías en la escala Atwater general. Los porcentajes superiores a cien también fallan la validación porque un porcentaje de la energía total no puede superar el todo. Envíe calories como número finito positivo en kilocalorías por día; se aceptan los alias total_calories, kcal, energy_kcal, calorie_intake y calorie_intake_kcal para que productos que ya guardan la energía con otra clave no necesiten una capa de traducción. Envíe carb_percent como porcentaje finito positivo de la energía total procedente de carbohidratos, como máximo cien; los alias carbohydrate_percent, carbs_percent, carb_pct, percent y pct mapean al mismo campo. El motor devuelve el eco de calories y carb_percent normalizados, luego carb_calories_kcal, carb_g, kcal_per_gram fijo en cuatro, unit en g/day, una cadena formula que puede mostrar en la ayuda de la interfaz, y method igual a atwater_carb_4kcal_g para que los clientes ramifiquen sin husmear formas. Si falta algún campo, no es finito, es cero o negativo, la petición falla con invalid_input y no se cobra. Entradas idénticas producen siempre el mismo JSON porque el algoritmo no toca la red, un modelo de lenguaje, un reloj de pared ni un generador aleatorio: exactamente el contrato que necesitan la automatización y las demos de tipo ejercicio.

Cómo leer los campos de respuesta y errores habituales

No trate la salida como prescripción médica: personas con diabetes, enfermedad renal, trastornos del almacenamiento de glucógeno o dietas clínicas necesitan orientación profesional. En caso de éxito la respuesta incluye calories y carb_percent como ecos limpios para que el cliente confirme qué se calculó sin reanalizar formularios de texto libre. El número principal de planificación es carb_g en gramos por día: la cantidad de carbohidrato que entregaría la fracción energética pedida a cuatro kilocalorías por gramo. El campo carb_calories_kcal muestra la asignación energética intermedia, útil cuando un panel ya muestra columnas de calorías de proteína y grasa y necesita una tercera columna coherente. kcal_per_gram es siempre cuatro, unit es siempre g/day, formula reexpresa carb_g igual a calories por carb_percent entre cien entre cuatro, y method es siempre atwater_carb_4kcal_g para un versionado estable de la ruta Atwater de carbohidratos. Use carb_g cuando un planificador de comidas solo necesita un presupuesto diario en gramos; use carb_calories_kcal cuando dibuje gráficos de macros en unidades de energía en lugar de masa. Ingestas calóricas extremadamente altas por encima del techo de seguridad del isolate se rechazan para acotar el trabajo del Worker. Recuerde que el alcohol y los alcoholes de azúcar quedan fuera de este endpoint; si su producto rastrea por separado la energía del etanol, réstela antes de llamar o trate esta calculadora solo como la porción de carbohidratos de un plan macro más amplio.

Uso de la API, precios, flujos de coaching y límites prácticos

Llame a la calculadora gratuita de ingesta de carbohidratos en el navegador para comprobaciones rápidas, educación al cliente, demos de clase y planificación de la lista de la compra sin instalar una hoja de nutrición. Prefiera ingestas calóricas que ya coincidan con la estimación energética diaria de su producto; si solo conoce BMR o TDEE, resuélvalos primero y elija después un porcentaje de carbohidratos adecuado al objetivo (por ejemplo más alto en bloques de resistencia de alto volumen, moderado en mantenimiento equilibrado, más bajo en experimentos low-carb deliberados). Mantenga expectativas educativas: es una herramienta de planificación y alfabetización, no un dispositivo médico de diagnóstico, y quienes tengan necesidades clínicas atípicas deben seguir orientación profesional antes que una sola fórmula. Envíe un cuerpo JSON con calories y carb_percent obligatorios (o sus alias). Use la API prepago cuando un SaaS de bienestar, un formulario de telemedicina, un pipeline de nutrición deportiva o una app de seguimiento calórico necesiten un contrato estable bajo saldo KIT a $0.002 por ítem correcto; los fallos de validación no consumen saldo tras el rechazo del motor. Combine este endpoint con su base de registro de alimentos: calcule aquí el objetivo en gramos y luego compare el carbohidrato registrado con carb_g en el cliente. Autores de SDK pueden mapear carb_g y carb_calories_kcal a tarjetas de panel y columnas CSV etiquetadas como carbohidratos diarios y calorías de carbohidratos: los mismos números que un coach escribe a mano al aplicar porcentaje de calorías entre cuatro en papel.