Scaleur de portions de recette

Les portions ou quantités non positives, les listes vides et les valeurs non finies sont rejetées avec invalid_input, afin qu'une donnée incorrecte ne produise jamais un lot silencieux à zéro. Le chemin est une arithmétique pure et déterministe—sans réseau, sans graines aléatoires, sans dépendance à l'horloge—ainsi l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après un arrondi décimal fixe à chaque appel.

Comment appeler l'API : champs, validation et forme de la réponse

Chaque amount doit être de même positif et fini ; une liste vide est rejetée car il n'y a rien à mettre à l'échelle. Préférez placer les unités dans le champ optionnel names plutôt qu'à l'intérieur des chaînes amount, afin que deux cent cinquante et la farine en grammes restent séparés et que le solver n'ait jamais à analyser un texte mixte. Envoyez un corps JSON avec amounts comme tableau obligatoire de nombres finis positifs—ou une chaîne séparée par des virgules sur les formulaires texte—plus original_servings et target_servings (les alias incluent servings, from_servings, original pour le compte source, et target, to_servings, new_servings pour la destination). Les deux comptes de portions doivent être des nombres finis strictement positifs ; zéro, négatifs, manquants ou non numériques renvoient invalid_input et ne sont jamais facturés. Les valeurs absolues restent dans la limite publiée d'un billion, et la longueur de la liste est plafonnée pour qu'un Worker termine rapidement. En succès la réponse renvoie amounts arrondis, scaled, scale_factor, original_servings, target_servings, count, names optionnels, des lignes ingredients associant chaque quantité d'origine à sa valeur mise à l'échelle, formula, message et steps ordonnés pour les pistes d'audit. Une validation échouée—amounts vides, nombres non finis, portions ou quantités non positives, ou champs obligatoires manquants—renvoie invalid_input avec un message nommant le problème. Le tarif est un forfait de $0.002 par requête réussie avec unit item et prix unitaire marginal nul.

Conseils pratiques, erreurs courantes, limites et outils associés

En mettant à l'échelle pour des invités, vérifiez que chaque ligne de la fiche est proportionnelle—certaines recettes laissent l'assaisonnement au goût ou fixent la taille de la poêle, vous pouvez donc mettre à l'échelle les ingrédients en vrac et laisser les pincées d'épices au jugement. Cette landing vise les personnes qui cherchent un scaleur de portions de recette, mettre les ingrédients à l'échelle par portions ou une calculatrice de rendement de lot ; ce n'est pas un convertisseur d'unités, ni un estimateur nutritionnel, ni un planificateur de repas complet. Préférez les outils frères de cuisine ou de conversion lorsque vous avez besoin de tasses de farine en grammes ou de cuillères à soupe en millilitres, puis mettez à l'échelle ici les nombres obtenus. Les contrôles aller-retour sont simples : recalculez à la main chaque amount multiplié par le facteur et confirmez qu'il égale l'entrée scaled publiée avec le même arrondi à douze décimales, et confirmez qu'en changeant seulement la cible chaque ligne est mise à l'échelle proportionnellement en laissant les étiquettes alignées. Maintenez toujours original_servings non nul et positif dans les formulaires client avant l'envoi ; l'API lèvera encore un invalid_input clair si un zéro ou un compte négatif passe, car diviser par zéro ou inventer un lot négatif n'est pas une mise à l'échelle significative. Préférez des nombres plutôt que des chaînes d'unités préformatées dans amounts ; placez les unités dans le champ optionnel names. Les valeurs flottantes proches des limites sont arrondies à douze décimales pour une comparaison JSON stable entre moteurs. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts d'exploration peu coûteux lorsque les apprenants envoient volontairement des portions nulles ou des listes vides. Pour le traiteur, convertissez un lot pilote écrit pour huit assiettes en un service de quarante-huit en envoyant original_servings huit et target_servings quarante-huit, afin que le facteur soit dérivé automatiquement sans champ multiplicateur séparé.