Escale a receita pelo ingrediente em mãos

Este escalonador de receitas por sobras toma cada quantidade numérica da sua lista de ingredientes, escolhe uma linha limitante (por índice ou por nome) e multiplica a lista inteira por on_hand dividido pela quantidade dessa linha na receita. Quantidades não positivas e um estoque on_hand não positivo são rejeitados com invalid_input em vez de inventar um prato zerado. O caminho é aritmética determinística pura com arredondamento decimal fixo, de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON sempre que você chama.

O que significa escalar por sobras e como o fator é montado

O solver calcula um único fator compartilhado igual a on_hand dividido pela quantidade da receita na linha limitante e multiplica cada quantidade por esse fator para manter as proporções relativas. Unidades não são convertidas de propósito aqui — use gramas ou xícaras tanto na quantidade da receita quanto em on_hand para o quociente ser adimensional — e conversores cook irmãos podem normalizar xícaras em gramas antes de escalar. Folhas de aula e coding kata podem afirmar o mesmo JSON arredondado porque a aritmética nunca depende do relógio nem de dados externos.

Como chamar a API: campos, formato da resposta e erros

Envie um corpo JSON com amounts como array obrigatório de números finitos positivos — ou uma string separada por vírgulas em formulários de texto — mais on_hand como a quantidade positiva do ingrediente limitante que você realmente tem. Escolha a linha limitante com limiting_index (base zero; padrão zero se omitido) ou limiting_name, comparado sem distinguir maiúsculas à lista opcional names; quando ambos vêm preenchidos, o nome vence para scripts identificarem farinha sem fixar posições. Names (aliases labels, ingredients) são rótulos paralelos opcionais preenchidos ou truncados ao contagem de amounts. Valores absolutos ficam dentro do limite publicado de um trilhão, e o comprimento da lista é limitado para um Worker terminar rápido. Em sucesso a resposta ecoa amounts arredondados, scaled, factor, on_hand, limiting_index, limiting_name, recipe_amount dessa linha, count, names, linhas ingredients com flag is_limiting, formula, message e steps ordenados. Validação falha — amounts vazios, números não finitos, qualquer quantidade de receita não positiva, on_hand não positivo, índice fora da faixa ou limiting_name sem correspondência — devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item. Prefira números em vez de strings de unidade dentro de amounts; coloque unidades em names para que duzentos e cinquenta e flour (g) fiquem separados e legíveis no array ingredients.

Dicas práticas, buscas relacionadas e quando usar outra ferramenta

Valores próximos de zero e negativos são rejeitados de propósito porque estoque ou linha de receita não positivos não definem uma escala útil. Esta landing mira quem busca escalar receita pelo ingrediente em mãos, calculadora de sobras limitantes ou escala a partir da despensa; não é conversor de unidades, nem estimador nutricional, nem o escalonador por porções ou multiplicador quando você já sabe o número de convidados. Prefira o escalonador de receitas irmão quando quiser fator dois para lote duplo, e ferramentas de xícaras para gramas quando ficha e saco usam medidas diferentes. Mantenha sempre on_hand e a quantidade de receita limitante na mesma unidade antes de enviar; misturar xícaras de farinha com gramas de estoque produz um fator matematicamente válido, porém culinariamente errado. Prefira limiting_name quando a lista é estável e limiting_index quando monta amounts por programa sem rótulos. Se vários ingredientes estão curtos, escolha o gargalo real — a linha com menor razão on_hand sobre quantidade de receita — ou rode a calculadora uma vez por candidato e fique com o lote escalado mínimo. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando aprendizes enviam estoque zero de propósito. Checagens de ida e volta são simples: recalcule à mão on_hand dividido pela quantidade de receita limitante, multiplique cada linha e confirme que as entradas scaled publicadas batem no arredondamento de doze casas, inclusive que o scaled da linha limitante iguale on_hand após o arredondamento.