Escalonador de receitas

Um fator de zero é rejeitado com invalid_input porque zerar cada linha apagaria a receita em vez de escalá-la. O caminho é aritmética determinística pura —sem rede, sem sementes aleatórias, sem dependência do relógio de parede— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após arredondamento decimal fixo a cada chamada.

O que significa escalar uma receita e quando usar um multiplicador

A ferramenta aceita uma lista não vazia de números finitos como amounts, nomes paralelos opcionais como rótulos, e devolve tanto um array scaled plano quanto um array ingredients que emparelha cada quantidade original com seu valor escalado. Planilhas de sala 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: modo fator, modo porções e a resposta

Se factor e target aparecerem, o factor explícito vence para que scripts que já calcularam a razão não sejam sobrescritos. Envie um corpo JSON com amounts como array obrigatório de números finitos —ou uma string separada por vírgulas em formulários de texto— mais factor ou target sob a regra publicada de exigir um deles. Factor (aliases multiplier, scale, times) é o coeficiente de escala explícito aplicado a cada quantidade. Target (aliases to_servings, target_servings, for) é um contagem de porções desejado; quando você usa target sem factor, o solver define factor igual a target dividido por servings, e servings tem padrão um se você omitir a contagem original. Valores absolutos devem permanecer dentro do limite publicado de um trilhão, e o comprimento da lista é limitado para que um Worker termine rápido. Em sucesso a resposta ecoa amounts arredondados, scaled, factor, count, mode (multiplier ou servings), servings e target opcionais, names, linhas ingredients, formula, message e steps ordenados. Validação falha —amounts vazios, números não finitos, factor e target ausentes, um divisor de servings original zero, ou um factor de zero— devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço unitário marginal zero.

Dicas práticas, erros de fator zero, limites e buscas relacionadas

Sempre rejeite um fator de zero em formulários do cliente antes de enviar quando puder; a API ainda lançará uma mensagem clara invalid_input se zero escapar, porque zerar cada ingrediente não é uma escala significativa. Ao escalar por porções, mantenha a contagem original diferente de zero — de quatro a seis é um caminho comum e produz fator 1.5 — e lembre-se de que servings tem padrão um quando só target é enviado, útil para receitas escritas por pessoa. Prefira números em vez de strings de unidade pré-formatadas dentro de amounts; coloque unidades no campo opcional names para que duzentos e cinquenta e farinha (g) fiquem separados. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando aprendizes enviam factor zero de propósito.