ForHosting KIT · Maison, cuisine et loisirs

Calculateur de punch de fête

Passez un punch testé pour 8 à un bol pour 24 : 250, 500 et 750 d'alcool, de jus et de boisson gazeuse deviennent 750, 1500 et 2250, avec la quantité par verre et la part de chaque élément. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Spiritueux: 250
Jus: 500
Mixer: 750
Portions: 8
Portions souhaitées: 24

Vous obtenez

Facteur: 3
Total de spiritueux: 750
Total de jus: 1 500
Total de mixer: 2 250

Un punch de fête repose presque toujours sur les mêmes trois volumes—spiritueux, jus et mixer—notés pour un petit lot d'essai puis multipliés pour le bol sur la table. Hôtes, traiteurs et programmes de bar doivent multiplier ces trois quantités pour un vrai nombre d'invités sans casser l'équilibre de la recette d'origine. Ce calculateur de lot de punch prend les volumes de spiritueux, de jus et de mixer de votre recette de base, un nombre optionnel de portions d'origine (une par défaut) et un nombre positif de portions cibles, puis renvoie les totaux du lot mis à l'échelle, le volume par portion et la part en pourcentage de chaque composant pour que le bol conserve le goût de l'échantillon. Un spiritueux à zéro est autorisé pour un punch sans alcool; les volumes négatifs sont rejetés.

Comment spiritueux, jus et mixer deviennent un lot de fête

Les recettes de punch sont en général notées comme trois volumes mesurés dans la même unité—millilitres, onces liquides ou tasses—pour un nombre connu de portions. La mise à l'échelle est linéaire: si la recette de base donne huit portions et que vous en voulez vingt-quatre, chaque composant est multiplié par trois. La méthode ne convertit pas les unités pour vous: saisissez les trois volumes de base dans une seule unité et lisez les totaux mis à l'échelle dans cette même unité.

Elle n'estime pas non plus le titre alcoométrique ni la fonte de la glace; cela dépend du degré, de la dilution et du temps de service du bol. Ce qu'elle garantit, c'est une échelle linéaire déterministe pour qu'une liste de vingt-quatre portions ait le même goût qu'un lot d'essai de huit lorsque les mêmes ratios sont utilisés.

Où un calculateur de lot de punch prouve son utilité

Les hôtes à domicile qui ont testé une petite carafe pour huit et ont soudain besoin d'un bol pour vingt-quatre invités peuvent multiplier spiritueux, jus et mixer sans refaire à la main le calcul du goût. Les bars de traiteur et les planificateurs d'événements mettent à l'échelle le même punch maison pour mariages et soirées d'entreprise avec des fiches de prep déterministes afin que deux équipes achètent les mêmes cartons.

Les cours de cuisine et de mixologie enseignent la préservation des ratios en montrant que tripler les portions triple chaque composant; un oracle pur permet aux élèves de vérifier les devoirs en quelques secondes. Préférez cette capacité lorsque votre punch se définit par trois volumes et un nombre de portions; ce n'est pas un scaleur général de recettes à liste ouverte d'ingrédients, ni un estimateur d'ABV, ni un modèle de dilution par glace, ni un guide de free-pour de cocktails unitaires.

Cas d’usage

Passer d'une carafe d'essai au bol de fête

Saisissez spiritueux, jus et mixer d'un lot d'essai de 8 portions et un nombre de 24 invités pour obtenir les totaux d'achat dans la même unité.

Fiches de prep traiteur et bar

Convertissez le ratio de punch maison en quantités de cartons déterministes pour mariages et événements multi-équipes sans réécrire la recette.

Applications, devoirs et punch sans alcool

Alimentez un champ d'invités dans une app de recettes, vérifiez des devoirs de ratios ou mettez à l'échelle un mocktail avec spirit à zéro comme un bol alcoolisé.

Questions fréquentes

Puis-je préparer un punch sans alcool?

La mise à l'échelle multiplie toujours les trois champs et renvoie totaux et pourcentages.

Dois-je convertir les unités moi-même?

Les totaux mis à l'échelle utilisent cette même unité; le calculateur ne convertit pas entre unités.

Combien de punch par verre ?

Dans l'exemple porté à 24 portions, chaque verre reçoit 187,5 : 31,25 d'alcool, 62,5 de jus et 93,75 de boisson gazeuse, dans l'unité que vous avez saisie. De quoi servir facilement depuis le bol.

Indique-t-il la force du punch ?

Non. Il n'estime ni le degré d'alcool ni la fonte de la glace, qui dépendent de l'alcool choisi, de la dilution et du temps passé sur la table. Il affiche plutôt la part de chaque élément dans le total.

Quel est l'équilibre classique d'un punch ?

Un repère courant est d'environ une part d'alcool pour deux de jus et trois de boisson gazeuse. Le calculateur garde exactement vos propres proportions et affiche chaque part, pour comparer la grande fournée à ce repère.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/cook/punch-scale

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/cook/punch-scale \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spirit":250,"juice":500,"mixer":750,"target_servings":24}'

const res = await fetch("https://api.kit.forhosting.com/cook/punch-scale", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "spirit": 250,
    "juice": 500,
    "mixer": 750,
    "target_servings": 24
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/cook/punch-scale",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "spirit": 250,
    "juice": 500,
    "mixer": 750,
    "target_servings": 24
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/punch-scale", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"spirit":250,"juice":500,"mixer":750,"target_servings":24}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"spirit":250,"juice":500,"mixer":750,"target_servings":24}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/punch-scale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "spirit": 250,
  "juice": 500,
  "mixer": 750,
  "target_servings": 24
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "cook.punch_scale",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Des portions ou cibles non positives échouent avec invalid_input au lieu d'inventer un lot nul ou négatif.

Comment spiritueux, jus et mixer deviennent un lot de fête

En symboles, servings est le rendement de base positif (un par défaut s'il est omis), target_servings est le nombre positif d'invités ou de verres souhaité, et factor égale target_servings divisé par servings. Alors spirit_total égale spirit multiplié par factor, juice_total égale juice multiplié par factor, mixer_total égale mixer multiplié par factor, et total_volume est la somme de ces trois volumes mis à l'échelle. Les champs par portion divisent chaque total par target_servings pour qu'un barman puisse servir des verres unitaires depuis le bol, et les champs de pourcentage indiquent chaque composant comme part de total_volume afin que vous puissiez vérifier qu'un grand lot reste proche d'un équilibre classique de punch—souvent environ une part de spiritueux pour deux de jus et trois de mixer, bien que vos propres ratios soient conservés exactement.

Contrat d'entrée, forme de réponse et comportement d'erreur

Une validation échouée ne consomme pas le solde prépayé. Envoyez un corps JSON avec trois nombres finis non négatifs obligatoires—spirit (alias liquor, alcohol, booze, spirit_ml, spirit_volume), juice (alias fruit_juice, citrus, juice_ml, juice_volume) et mixer (alias soda, sparkling, soft_drink, mixer_ml, mixer_volume)—plus un target_servings positif obligatoire (alias target, to_servings, guests, party_servings, for). Le servings optionnel (alias base_servings, original_servings, from_servings, recipe_servings, n) vaut un par défaut et doit être positif s'il est fourni. Champs obligatoires manquants, chaînes vides, valeurs non finies, volumes négatifs, servings à zéro, target_servings à zéro et nombres de portions négatifs échouent avec invalid_input en nommant le problème et ne sont pas facturés. En cas de succès le corps renvoie spirit, juice, mixer, servings et target_servings; renvoie factor; renvoie spirit_total, juice_total, mixer_total et total_volume; renvoie spirit_per_serving, juice_per_serving, mixer_per_serving et volume_per_serving; renvoie spirit_pct, juice_pct et mixer_pct (pourcentages du volume total, ou zéro si le total est zéro); et inclut formula, method et un message d'une ligne en anglais pour l'interface. Exemple: spirit deux cent cinquante, juice cinq cents, mixer sept cent cinquante pour huit portions mises à l'échelle vers vingt-quatre donne factor trois et des totaux sept cent cinquante, mille cinq cents et deux mille deux cent cinquante avec un volume total de quatre mille cinq cents dans la même unité saisie.

Où un calculateur de lot de punch prouve son utilité

Les sites de recettes et les applications de planification de fête peuvent appeler un endpoint de parse minimal lorsqu'un utilisateur saisit un nombre d'invités et attendre des volumes de liste d'achats dans l'unité déjà utilisée. Comme l'implémentation est un parse pur de tier A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Servez l'alcool de façon responsable, étiquetez clairement les options sans alcool et refroidissez le bol—ces règles de service restent hors du périmètre numérique de cet endpoint mais comptent en salle.

Questions techniques

Comment mettre à l'échelle une recette de punch de fête par portions?

Envoyez des volumes non négatifs de spirit, juice et mixer pour la recette de base, un servings positif optionnel (défaut 1) et un target_servings positif. L'API renvoie factor = target_servings ÷ servings et multiplie chaque volume par ce facteur.

Que se passe-t-il si servings ou target_servings est zéro ou négatif?

La tâche échoue avec invalid_input. Les deux nombres de portions doivent être des nombres finis strictement positifs; les valeurs non positives ne sont pas facturées.

Combien coûte le calculateur de lot de punch?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment spiritueux, jus et mixer deviennent un lot de fête

Où un calculateur de lot de punch prouve son utilité

Cas d’usage

Passer d'une carafe d'essai au bol de fête

Fiches de prep traiteur et bar

Applications, devoirs et punch sans alcool

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comment spiritueux, jus et mixer deviennent un lot de fête

Contrat d'entrée, forme de réponse et comportement d'erreur

Où un calculateur de lot de punch prouve son utilité

Questions techniques

merci