Calculadora de calorias de café

Se sugar_teaspoons for negativo, a tarefa falha com invalid_input em vez de inventar um total energético negativo.

Tipo de café e a tabela de quilocalorias de base

Uma calculadora de calorias de café saudável só é útil quando o nome da bebida está ligado a uma cifra de energia conhecida, não a um especial vago de cafeteria. Esta capacidade guarda uma tabela fechada de quilocalorias de base só da porção de café, sem leite e sem açúcar, para treze tipos canônicos: espresso a 3, doppio a 6, americano a 5, black a 2, cold_brew a 5, latte a 5, cappuccino a 5, flat_white a 5, macchiato a 3, french_press a 7, pour_over a 5, instant a 4 e turkish a 7. Esses números são valores típicos no estilo USDA do café infundido em si, de modo que um latte e um cappuccino compartilham a mesma energia de base e diferem no leite que você envia à parte. O campo coffee_type é um enum: o formulário pinta um seletor, a API rejeita strings desconhecidas com invalid_input, e dois clientes nunca discordam se latte significa uma bebida de espresso com leite à frente. Aliases como drip, black coffee, cold brew e flat white resolvem para os ids canônicos, mas a resposta sempre ecoa a chave canônica. Se você precisa de uma bebida de cafeteria sob medida, escolha o tipo mais próximo e coloque os mililitros reais de leite e as colheres de chá de açúcar nos outros campos; este endpoint não aceita um override de calorias em texto livre, porque um número livre tornaria inútil a página do tipo de café.

Volume de leite, colheres de chá de açúcar e a identidade calórica

A maior parte da energia de uma bebida de cafeteria não é o espresso. É o leite e o açúcar. O volume de leite é obrigatório e se mede em mililitros. Zero mililitros é uma xícara preta; um jato típico de cappuccino fica por volta de 120 mililitros e um despejo de latte costuma ser 180 mililitros ou mais. Frações são permitidas quando alguém usou meia colher de chá; zero colheres de chá não traz energia de açúcar. As calorias do leite usam leite integral de vaca a 64 quilocalorias por 100 mililitros, então milk_kcal equivale a milk_volume vezes 64 dividido por 100. O modelo não troca para desnatado, aveia nem amêndoa: essas bebidas têm densidades e rótulos diferentes, e misturá-las num único campo de volume faria o mesmo recuento de mililitros significar duas energias distintas. sugar_teaspoons é obrigatório e conta açúcar granulado. Cada colher de chá se trata como 4 gramas a 4 quilocalorias por grama, que são 16 quilocalorias, então sugar_kcal equivale a sugar_teaspoons vezes 16. Um valor negativo de sugar_teaspoons não é uma xícara, é um erro de dados, e a tarefa falha com invalid_input nomeando o campo e afirmando que colheres de chá de açúcar não podem ser negativas. Essas falhas não são cobradas. As calorias totais equivalem a coffee_kcal mais milk_kcal mais sugar_kcal.

Contrato de entrada, forma da resposta e onde encaixa

A validação falha não consome saldo. Envie um corpo JSON com três campos obrigatórios: coffee_type (um dos treze ids canônicos), milk_volume (mililitros não negativos, máximo 2000) e sugar_teaspoons (contagem não negativa, máximo 50). Campos ausentes, números não finitos, um tipo de café desconhecido, um volume de leite negativo, uma contagem de açúcar negativa e valores acima dos limites declarados falham como invalid_input com uma mensagem que nomeia o campo. Em caso de sucesso o corpo inclui o coffee_type, milk_volume e sugar_teaspoons ecoados; coffee_kcal da tabela; milk_kcal; sugar_kcal; calories como a soma; e uma string curta de fórmula. Exemplo: coffee_type latte, milk_volume 180, sugar_teaspoons 1 produz 5 mais 115.2 mais 16, que são 136.2 quilocalorias. Combine o número com o seu diário de refeições ou orçamento restante; este endpoint só converte uma bebida de café em quilocalorias. Como a implementação é parse puro de tier A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.