← Tous les guides
Sur cette page
Tutoriel Stratégie GTO · 02/06 Entraîneur 18 min Intermédiaire

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.

Mis à jour Maintenu par Pokerai API

1 · Premier appel 2 · La grille des ranges 3 · Arbre postflop 4 · Résolution au tournant et à la rivière

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
Relancer comme se coucher avec A2s ici sont tous deux corrects selon la GTO. Un joueur qui se couche toujours, ou qui relance toujours, ne se "trompe" pas sur une main donnée — mais sur un grand nombre de mains, il s'écarte du mélange d'équilibre. C'est exactement ce que mesure un entraîneur.

É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)
Voici exactement comment Counterplay évalue — la sévérité provient de la fréquence propre de l’action choisie, donc les actions mixtes à faible fréquence ne sont pas pénalisées. (Voir l’étude de cas.)

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.

Suivant — Partie 2 : la grille de range 13×13

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