ForHosting KIT · Outils pour développeurs

Calculateur de valeur d’une main de blackjack

Ce calculateur lit des codes de cartes usuels et renvoie le total légal le plus élevé de la main.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Les as valent d’abord 11, puis passent automatiquement à 1 lorsque cela évite ou réduit un dépassement de 21. Le résultat précise aussi si le total est souple, si deux cartes forment un blackjack naturel et si la main dépasse toujours 21. Chaque code doit désigner une carte unique d’un jeu standard de 52 cartes ; un code incorrect ou un doublon impossible produit une erreur explicite.

Saisissez une vraie main issue d’un jeu standard

Écrivez chaque carte avec son rang immédiatement suivi de sa couleur. Les rangs admis sont 2 à 10, J, Q, K et A ; les couleurs sont C pour trèfle, D pour carreau, H pour cœur et S pour pique. Séparez les cartes par des espaces ou des virgules : AS 10H et AS,10H décrivent la même main de deux cartes. La casse est indifférente, car les codes sont normalisés avant le calcul. Le calculateur valide le code entier au lieu de deviner une notation partielle. Ainsi, A sans couleur n’appartient pas au jeu standard de 52 cartes, et 1H ne remplace pas AH. La même carte exacte ne peut pas apparaître deux fois. Deux rois de couleurs différentes sont autorisés, mais deux KS sont impossibles dans un seul jeu physique. Ces règles rendent le résultat fiable pour la logique d’un jeu, les tests, les tutoriels et l’analyse d’historiques, où accepter une carte inventée masquerait une anomalie. La main doit contenir au moins une carte et au plus les 52 cartes uniques disponibles.

Comment l’ajustement des as trouve le meilleur total

Le calcul attribue d’abord 11 à chaque as, 10 à chaque figure et sa valeur imprimée à chaque carte numérotée. Si cette somme dépasse 21, il transforme un as après l’autre de 11 en 1, soit une réduction de 10 à chaque fois. Il s’arrête dès que le total atteint 21 ou moins, ou lorsqu’aucun as ne vaut encore 11. Il obtient ainsi le total maximal permis par les règles du blackjack sans dépasser 21 chaque fois que cela reste possible. Avec AS 7D 3C, la valeur initiale est 21 : l’as conserve 11 et le résultat est un 21 souple. Avec AS 7D 8C, le total initial de 26 devient 16 lorsque l’as passe à 1. Plusieurs as suivent le même mécanisme : AS AD 9C commence à 31 et termine à 21 après un ajustement. La réponse indique combien d’as prennent chaque valeur. Si la main dépasse encore 21 après tous les ajustements, elle est correctement signalée comme brûlée.

Interprétez total souple, blackjack et dépassement

Le résultat principal, total, est la meilleure valeur de blackjack de toutes les cartes fournies. L’indicateur soft est vrai lorsqu’au moins un as vaut toujours 11 dans ce total. Une main souple garde une marge de sécurité : une carte élevée peut ramener cet as à 1 au lieu de provoquer immédiatement un dépassement. blackjack respecte la définition habituelle d’une main naturelle et n’est vrai que si exactement deux cartes totalisent 21. Un 21 obtenu avec trois cartes reste valable, mais n’est pas étiqueté blackjack. bust est vrai lorsque la meilleure valeur possible reste supérieure à 21 après tous les ajustements. Des champs supplémentaires donnent le nombre de cartes et la répartition des as entre 11 et 1. Une application n’a donc pas à reconstituer ces faits. Cette distinction sert aux interfaces et moteurs de règles : le total seul ne révèle ni un 21 naturel, ni un 18 souple, ni la perte de la valeur haute d’un as. Par l’API, chaque calcul déterministe coûte $0.002 par requête.

Compter les points d’une partie

Calculez le total après chaque donne ou tirage tout en distinguant correctement les mains dures des mains souples.

Valider des historiques de mains

Refusez les codes mal formés et les cartes physiques dupliquées avant l’import dans un outil d’analyse ou de replay.

Créer des exercices de stratégie

Produisez des étiquettes fiables pour les blackjacks naturels, totaux souples, totaux durs et dépassements.

Comment faut-il écrire chaque carte ?

Utilisez un rang suivi de la lettre de couleur, par exemple AS pour l’as de pique, 10H pour le dix de cœur ou KC pour le roi de trèfle. Séparez les cartes par des espaces ou des virgules.

Comment plusieurs as sont-ils comptés ?

Chaque as commence à 11. Tant que le total dépasse 21, les as passent un à un à 1 jusqu’à éviter le dépassement ou épuiser les as hauts.

Quand un total est-il souple ?

Un total est souple lorsqu’au moins un as vaut encore 11. Si tous les as ont été ramenés à 1, le total est dur.

Tout total de 21 est-il un blackjack ?

Non. L’indicateur blackjack n’est vrai que pour un 21 en deux cartes. Un total de 21 avec trois cartes ou plus n’est pas un blackjack naturel.

Pourquoi les cartes dupliquées sont-elles refusées ?

L’entrée représente un jeu standard de 52 cartes. Une même carte physique ne peut apparaître deux fois, mais des rangs identiques de couleurs différentes sont valides.

Quel est le prix d’un calcul par API ?

Chaque requête API coûte $0.002. L’algorithme est déterministe et n’emploie aucun service réseau ni comportement aléatoire.

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.

POSThttps://api.kit.forhosting.com/game/blackjack-hand-value

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é.

curl -X POST https://api.kit.forhosting.com/game/blackjack-hand-value \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hand":"AS 7D 3C"}'
{
  "hand": "AS 7D 3C"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.blackjack_hand_value",
  "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.

par requête$0.002

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

max_items52
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →