Escalador de recetas

Un factor de cero se rechaza con invalid_input porque anular cada línea borraría la receta en lugar de escalarla. La ruta es aritmética determinista pura —sin red, sin semillas aleatorias, sin dependencia del reloj de pared— de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras un redondeo decimal fijo cada vez que se llama.

Qué significa escalar una receta y cuándo usar un multiplicador

La herramienta acepta una lista no vacía de números finitos como amounts, nombres paralelos opcionales como etiquetas, y devuelve tanto un array scaled plano como un array ingredients que empareja cada cantidad original con su valor escalado. Las hojas de aula y las coding kata pueden afirmar el mismo JSON redondeado porque la aritmética nunca depende del reloj ni de datos externos.

Cómo llamar a la API: modo factor, modo raciones y la respuesta

Si aparecen factor y target, gana el factor explícito para que scripts que ya calcularon la razón no se sobrescriban. Envíe un cuerpo JSON con amounts como array obligatorio de números finitos —o una cadena separada por comas en formularios de texto— más factor o target bajo la regla publicada de exigir uno de ellos. Factor (alias multiplier, scale, times) es el coeficiente de escala explícito aplicado a cada cantidad. Target (alias to_servings, target_servings, for) es un recuento de raciones deseado; cuando usa target sin factor, el solver fija factor igual a target dividido por servings, y servings por defecto es uno si omite el recuento original. Los valores absolutos deben permanecer dentro del límite publicado de un billón (en escala corta: un trillón estadounidense), y la longitud de la lista está acotada para que un Worker termine rápido. En caso de éxito la respuesta devuelve amounts redondeados, scaled, factor, count, mode (multiplier o servings), servings y target opcionales, names, filas ingredients, formula, message y steps ordenados. La validación fallida —amounts vacíos, números no finitos, factor y target ausentes, un divisor de servings original cero, o un factor de cero— devuelve invalid_input y nunca se cobra. El precio es un $0.002 plano por petición correcta con unidad item y precio unitario marginal cero.

Consejos prácticos, errores de factor cero, límites y búsquedas afines

Rechace siempre un factor de cero en formularios del cliente antes de enviar cuando pueda; la API aún lanzará un mensaje claro invalid_input si se cuela un cero, porque anular cada ingrediente no es una escala significativa. Al escalar por raciones, mantenga el recuento original distinto de cero —de cuatro a seis es un camino habitual y produce factor 1.5— y recuerde que servings por defecto es uno cuando solo se envía target, útil para recetas escritas por persona. Prefiera números en lugar de cadenas de unidad preformateadas dentro de amounts; ponga las unidades en el campo opcional names para que doscientos cincuenta y harina (g) queden separados. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los aprendices envían factor cero a propósito.