Comment exécuter un flux de travail de solveur GTO ?
Créez une résolution personnalisée pour le flop, le turn ou la river, vérifiez régulièrement son arbre jusqu’à ce qu’il puisse être interrogé, puis demandez la stratégie d’un nœud terminé.
POST /v1/gto/solver, conservez l’identifiant solve renvoyé, vérifiez régulièrement POST /v1/gto/solver/tree jusqu’à ce que spot_status soit queryable, puis transmettez le token d’un nœud renvoyé à POST /v1/gto/solver/node. Un 503 upstream_unavailable signifie que le service amont du solveur est resté indisponible après les nouvelles tentatives effectuées par le service lui-même ; effectuez de nouvelles tentatives pour la même requête avec un backoff exponentiel borné, mais n’effectuez pas de nouvelles tentatives pour une entrée non valide.Faits rapides
| Élément | Valeur |
|---|---|
| Créer | POST /v1/gto/solver planifie une résolution au flop, au turn ou à la river ; la longueur du board sélectionne la street. |
| Disponibilité | Vérifiez régulièrement POST /v1/gto/solver/tree jusqu’à ce que spot_status soit queryable. |
| Lire | Passez le token d’un nœud de l’arbre à POST /v1/gto/solver/node. |
| Quota | Une nouvelle résolution utilise un quota de résolution ; la réutilisation en cache, les lectures de l’arbre et les lectures de nœuds ne consomment pas de quota de résolution. |
| Offre gratuite | 1 000 consultations pré-résolues + 25 résolutions en temps réel par mois. |
Quand l’utiliser
Utilisez ce flux de travail pour une situation personnalisée au flop, au turn ou à la river lorsque vous devez soumettre le board, les ranges, le pot, le tapis effectif et la position du Héros. Il s’agit du cycle de vie d’un identifiant de résolution soumis, et non d’une affirmation concernant tous les formats de poker ou la qualité des résultats.
Quand ne pas l’utiliser
Ne l’utilisez pas pour une assistance en temps réel avec de l’argent réel (RTA) : Pokerai API est destinée à l’entraînement, au coaching, à la révision des mains, à l’étude et à la recherche. Ne considérez pas une réponse computing, expired, no_nodes ou error d’un nœud comme une stratégie terminée.
Requête minimale vérifiable
curl -s https://pokerai.bet/v1/gto/solver -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"board":"2c2h2s","oop_range":"AA,KK","ip_range":"QQ,JJ","pot":6,"effective_stack":100,"hero":"OOP"}'Conservez l’identifiant solve de la réponse. Une réponse peut indiquer computing ou queryable ; seul un nouveau déclenchement inclut solve_quota.
Vérifiez régulièrement l’arbre, puis lisez un nœud terminé
curl -s https://pokerai.bet/v1/gto/solver/tree -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"solve":"<identifiant solve>"}'curl -s https://pokerai.bet/v1/gto/solver/node -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"node":"<token de nœud provenant d’un arbre interrogeable>"}'Pour un nœud du Héros, la forme de réussite documentée contient strategy. Pour un nœud du vilain, ou lorsque hole_cards est omis, la réponse documentée peut fournir actions et range_strategy. Ne consommez que les champs documentés par le contrat OpenAPI actuel.
Statut et gestion des erreurs
| Signal | Signification | Que faire |
|---|---|---|
computing | La résolution ou le nœud est toujours en cours de traitement. | Vérifiez à nouveau l’arbre ; ne demandez pas la stratégie comme si elle était terminée. |
queryable | L’arbre est prêt à être inspecté. | Sélectionnez le token d’un nœud renvoyé et appelez /v1/gto/solver/node. |
no_nodes | La street ou le runout interrogé ne comporte aucun nœud de décision. | Arrêtez de vérifier cette street ou ce runout. |
expired | La résolution a été récupérée ou remplacée. | Planifiez une nouvelle résolution ; l’ancien identifiant ne peut pas être interrogé. |
error | Le nœud signale une erreur de stratégie, éventuellement avec message. | Traitez-le comme un nœud en échec ; ne le présentez pas comme une stratégie. |
HTTP 429 avec status: busy | Tous les hôtes du solveur sont occupés. | Effectuez de nouvelles tentatives avec backoff ; cela ne consomme pas de quota. |
HTTP 503 | L’amont de l’arbre ou du nœud est indisponible. | Traitez-le comme transitoire et effectuez de nouvelles tentatives avec backoff lorsque c’est approprié. |
Quota et ressources associées
Une nouvelle résolution consomme le compteur de résolutions en temps réel ; la réutilisation d’une résolution en cache et les lectures de l’arbre/des nœuds du solveur sont gratuites. Consultez la rubrique sur les quotas pour les compteurs mensuels actuels.
- Centre de documentation — concepts de l’API et authentification.
- Quotas — limites gratuites et gestion de
busy. - Référence API — schémas actuels des opérations du solveur.
- Instantané OpenAPI — contrat lisible par machine du cycle de vie du solveur.
- Guide de l’API du solveur GTO — un guide d’implémentation associé.
- Python SDK, TypeScript / JavaScript SDK et serveur MCP — points d’entrée des packages officiels.
Real-time assistance at real-money tables is prohibited.