Escalado de cócteles por raciones

Las raciones originales u objetivo no positivas fallan con invalid_input porque un rendimiento cero o negativo no define un escalado con sentido. El camino es aritmética pura y determinista—sin red, sin semillas aleatorias, sin dependencia del reloj—así que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que la invoca.

Qué significa escalar un lote de cócteles y por qué las proporciones se mantienen

Fija factor igual a target dividido por servings y devuelve tanto un array scaled plano como un array ingredients que empareja cada cantidad original con su valor escalado. Las hojas de clase, las hojas de cálculo de programas de bar y los kata de programación pueden afirmar el mismo JSON redondeado porque la aritmética nunca depende del reloj ni de datos externos.

Cómo llamar a la API: entradas, forma de la respuesta y validación

Los names opcionales aparecen en el nivel superior solo cuando se proporcionó al menos una etiqueta; los campos opcionales se omiten en lugar de fijarse a null. 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 servings para el rendimiento original y target para el recuento de bebidas deseado. Tanto servings como target deben ser finitos y estrictamente mayores que cero; los valores cero, negativos y no numéricos fallan con invalid_input y nunca se cobran. Los names opcionales (alias labels, ingredients) alinean etiquetas de texto con cada cantidad en el mismo orden; las etiquetas de más o de menos se rellenan o se recortan para que el número de filas siempre coincida. Los valores absolutos deben permanecer dentro de un billón, y la longitud de la lista está acotada para que un Worker termine con rapidez. En caso de éxito la respuesta repite amounts redondeados, valores scaled, factor, count, servings, target, filas de ingredients con index amount y scaled más name cuando exista, formula, message y steps ordenados. La validación fallida—amounts vacíos, números no finitos, servings o target ausentes, o raciones no positivas—devuelve invalid_input. El precio es un fijo $0.002 por solicitud exitosa con unidad item. Prefiera números en lugar de cadenas con unidades preformateadas dentro de amounts; ponga las unidades en el campo opcional names para que sesenta y gin (ml) queden separados y legibles por máquina.

Consejos prácticos para fiestas, bares, límites y herramientas relacionadas

Mantenga las unidades coherentes en la lista: si las líneas de destilado están en mililitros, mantenga también cítricos y jarabes en mililitros, y reserve gotas o piezas solo para las líneas que realmente usan esas unidades. Se permiten valores positivos cercanos a cero para líneas mínimas de amargos si su ficha los usa, pero las raciones originales u objetivo en cero se rechazan siempre. Esta página se dirige a quien busca una calculadora de escalado de lotes de cócteles, escalar una receta de cóctel para una fiesta o un multiplicador de bebidas en jarra; no es un convertidor de unidades, ni un estimador de ABV, ni un sistema completo de inventario de bar. Las comprobaciones de ida y vuelta son sencillas: recalcule a mano cada amount por factor y confirme que coincide con la entrada scaled publicada con el mismo redondeo a doce decimales, y confirme que al cambiar solo el target se escalan todas las líneas de forma proporcional. Rechace siempre las raciones no positivas en los formularios del cliente antes de enviar cuando pueda; la API igualmente lanzará un mensaje claro de invalid_input si se cuela un cero o un recuento de invitados negativo, porque dividir por un rendimiento no positivo o apuntar a cero bebidas no es un lote con sentido. Al escalar una ficha clásica de una sola ración, fije servings en 1 y target en el número de copas que planea servir—ocho para una cena, veinticuatro para una recepción pequeña. Para una receta ya escrita como agitado de dos bebidas, fije servings en 2 y target en el recuento completo de servicio para que el factor se derive correctamente sin contar dos veces. Prefiera las herramientas cook hermanas cuando necesite escalado general de recetas de cocina o coste por ración, y use este endpoint cuando la intención sea el rendimiento del cóctel. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts de exploración cuando se envía deliberadamente target cero.