Partie 1 : Votre premier appel de stratégie
Construisez le cœur d’un entraîneur de poker GTO à partir d’un scénario d’entraînement contrôlé ou d’une main terminée — le même type de couche stratégique qui alimente Counterplay. Cette partie effectue un véritable appel de stratégie préflop, lit ses fréquences mixtes vérifiables et évalue une décision après examen.
Ce dont vous aurez besoin
Une clé API gratuite (obtenez-en une ici) et curl ou Python 3. Définissez votre clé comme variable d’environnement :
export POKERAI_API_KEY="gto_your_key_here"
Étape 1 · Votre premier appel
Demandez la stratégie GTO lorsque le Héros détient A♥K♥ en MP et qu'UTG a relancé :
curl https://pokerai.bet/v1/gto/preflop \
-H "authorization: Bearer $POKERAI_API_KEY" \
-H "content-type: application/json" \
-d '{
"hole_cards": "AhKh",
"positions": { "hero": "MP" },
"preflop_actions": [
{ "position": "SB", "action": "small blind", "amount": 0.5 },
{ "position": "BB", "action": "big blind", "amount": 1 },
{ "position": "UTG", "action": "raise", "amount": 3 }
]
}'
Réponse :
{
"hole_cards": "AhKh",
"situation": "Raise",
"strategy": [
{ "action": "raise", "frequency": 1, "amount_bb": 9, "sizing_pot": 0.8 }
]
}
AKs face à une ouverture UTG est un 3-bet pur : relancez 100 % du temps, à 9bb. situation est dérivé des actions que vous avez envoyées (ici, face à une relance = "Raise").
Étape 2 · Lire les fréquences
L'idée clé : l'API renvoie une stratégie mixte — la frequency GTO de chaque action — et non un unique coup "recommandé". La plupart des mains sont pures (une action à 100 %), mais beaucoup sont mixtes. Par exemple, ouverture UTG avec A2s :
{ "action": "raise", "frequency": 0.296 } # raise 29.6% of the time
{ "action": "fold", "frequency": 0.704 } # fold 70.4% of the time
Étape 3 · Dans le code
Un petit client typé — de la même forme que celui utilisé par Counterplay (app/gto/client.py) :
import os, httpx
class Pokerai:
def __init__(self):
self.h = {"Authorization": f"Bearer {os.environ['POKERAI_API_KEY']}"}
self.c = httpx.Client(base_url="https://pokerai.bet", timeout=15)
def preflop(self, hole_cards, hero, actions):
r = self.c.post("/v1/gto/preflop", headers=self.h, json={
"hole_cards": hole_cards,
"positions": {"hero": hero},
"preflop_actions": actions,
})
r.raise_for_status()
return {s["action"]: s["frequency"] for s in r.json()["strategy"]}
gto = Pokerai()
strat = gto.preflop("AhKh", "MP", [{"position":"UTG","action":"raise","amount":3}])
print(strat) # {'raise': 1.0}
Étape 4 · Évaluer une décision
C’est le cœur de l’entraîneur. Évaluez l’action du Héros selon la fréquence GTO de l’action qu’il a choisie — et non selon son écart par rapport à l’action la plus fréquente. Une relance à une fréquence de 14 % est un bon jeu mixte, pas une erreur :
def grade(chosen_action, strategy):
freq = strategy.get(chosen_action, 0.0)
if freq >= 0.10: return "ok" # a real part of the GTO mix
if freq >= 0.005: return "minor" # rare, but not a blunder
return "major" # ~never played → a real leak
grade("raise", {"raise": 0.296, "fold": 0.704}) # "ok" (A2s raise)
grade("raise", {"fold": 1.0}) # "major" (raising 32o UTG)
Ce que vous avez créé
Une couche de stratégie opérationnelle : récupérez les fréquences GTO pour une situation d'entraînement documentée et évaluez la décision finalisée d'un joueur par rapport à l'équilibre. L'API Pokerai fournit les faits de stratégie déterministes ; tout coach ou LLM peut expliquer ces fréquences renvoyées, mais ne remplace pas le solveur. Cette boucle — situation → stratégie → évaluation — constitue l'intégralité de l'entraîneur, une phase de jeu à la fois.
Utilisation acceptable
N’acceptez que les entrées provenant de scénarios d’entraînement contrôlés ou de mains déjà terminées. Veillez à ce que l’évaluation, le coaching ou les résultats de produit à fort impact puissent être examinés par un humain. Pokerai API est destinée à l’entraînement, au coaching, à l’analyse de mains, à l’étude et à la recherche. L’assistance en temps réel aux tables d’argent réel est interdite.
Récupérez une range entière en un appel et affichez-la, comme sur les pages de ranges. Bientôt disponible.
Ressources associées
- Documentation développeur — authentification, quotas, erreurs et comportement des points de terminaison
- Référence API interactive — la référence interactive en direct pour chaque point de terminaison
- Spécification OpenAPI — le contrat d’API anglais lisible par machine
- Guide de l'API du solveur de poker GTO — la page de réponse principale pour choisir et appeler l’API de stratégie
- Guide de revue des mains après session — examiner une main terminée lorsque l'entrée de l'entraîneur provient d'une partie plutôt que d'un scénario contrôlé
- llms.txt — le point d’entrée LLM concis pour Pokerai API