Quand dois-je utiliser une API de solveur de poker hébergée plutôt qu’un solveur de bureau ?
Utilisez une API de solveur hébergée lorsque votre produit a besoin d'une requête de stratégie documentée et sans état qu'il peut effectuer de façon répétée. Utilisez un solveur de bureau lorsque vos recherches dépendent de la conception et de l'inspection d'un flux de résolution local personnalisé.
Faits comparables
| Interface d’API hébergée | Requêtes et réponses JSON sans état authentifiées par Bearer, documentées dans le contrat OpenAPI public |
|---|---|
| Accès à la stratégie hébergée | Consultations pré-résolues préflop et flop, ainsi que des résolutions personnalisées de flop, turn et river à la demande via des points de terminaison documentés |
| Flux de travail du solveur de bureau | Un flux de travail de recherche local pour construire un arbre, choisir les abstractions et les tailles, exécuter une résolution et inspecter ses résultats |
| Limite de reproductibilité | Une requête API n'est répétable que lorsque l'appelant conserve la requête complète, la version de l'API ou de la stratégie lorsqu'elle est prise en charge, ainsi que la réponse renvoyée |
| Utilisation autorisée | Entraînement, coaching, analyse de mains, étude et recherche — jamais d’assistance en temps réel aux tables d’argent réel |
Quand une API de solveur hébergée est-elle le meilleur choix ?
Choisissez une API hébergée lorsqu’un logiciel a besoin de stratégie dans un produit plutôt que dans la session de bureau d’un chercheur : par exemple, un entraîneur qui évalue une main, une file d’attente de revue de mains, un visualiseur de ranges, un service backend ou un agent IA avec validation humaine. Le produit peut appeler un point de terminaison documenté et afficher les fréquences mixtes, les ranges, les nœuds ou les EV renvoyés.
La frontière d'intégration est explicite. Votre application gère l'authentification, la validation des entrées, le stockage de ses propres enregistrements d'étude et la présentation. Pokerai API reçoit une situation sans état et renvoie du JSON ; elle n'exige pas que votre application distribue un binaire de solveur ou exploite un arbre de solveur local.
Quand un solveur de bureau est-il le meilleur choix ?
Choisissez un solveur de bureau lorsque le travail principal est la recherche : définir un nouvel arbre de jeu, sélectionner les abstractions et les tailles de mise, mener des expériences locales et examiner l’arbre obtenu en détail. Ces choix sont des paramètres d’une résolution, et non des hypothèses qu’une API hébergée peut déduire d’une brève demande produit.
Un flux de travail sur ordinateur est également l’endroit approprié pour comparer des configurations de recherche avant de publier un flux de travail d’étude fixe. Ne décrivez pas une réponse hébergée comme équivalente à une résolution locale configurée séparément, sauf si la configuration complète et les résultats ont été conservés et comparés.
Limites d’intégration et de reproductibilité
Pour une étude reproductible fondée sur une API, consignez le point de terminaison, le corps complet de la requête, la version de stratégie ou de l’API lorsque le point de terminaison en expose une, l’heure de la requête et la réponse renvoyée. Rejouer uniquement une description en langage naturel d’une situation ne suffit pas : les positions, les tapis, le board, la séquence d’actions, les choix de tailles et la version peuvent modifier le résultat.
Pour une résolution à la demande, conservez l’identifiant de résolution et la configuration d’origine pendant la lecture de son arbre, de ses nœuds et de ses EV. Les vérifications répétées ou les lectures de nœuds examinent cette résolution ; une nouvelle soumission est une demande de résolution distincte. Si vous avez besoin d’un artefact de recherche durable, conservez les entrées et sorties exportées dans votre propre système d’étude.
Utilisation sûre et sans RTA
L’API Pokerai est destinée à l’entraînement hors ligne, au coaching, à la revue de mains, à l’étude et à la recherche. L’assistance en temps réel aux tables d’argent réel est interdite.
Concevez les contrôles du produit autour de cette limite : conservez les fonctionnalités de stratégie dans des contextes d’étude et de révision, exigez une vérification humaine pour les explications générées par des agents, et ne transformez pas un flux de travail via API ou de bureau en conseils de jeu en direct.
Carte d’intégration
Utilisez le contrat public pour sélectionner une requête API ; utilisez un solveur de bureau lorsque votre tâche consiste à concevoir la configuration de recherche elle-même.
| Surface | Tâche du produit | Limite |
|---|---|---|
POST /v1/gto/preflop | Évaluer ou afficher une situation préflop | Une requête documentée pour une main, une position et une ligne d’actions ; pas un éditeur d’arbre local personnalisé. |
POST /v1/gto/flop/tree | Afficher un flux de travail de flop pré-résolu | Lisez l’arbre renvoyé et les jetons de nœud pour la configuration et le board demandés. |
POST /v1/gto/solver | Soumettre une situation personnalisée à la demande | Soumettez une configuration documentée, puis conservez son identifiant et ses entrées tout en examinant cette résolution. |
POST /v1/gto/solver/tree | Examiner une résolution terminée | Effectuez des vérifications répétées et lisez la résolution soumise ; elle ne remplace pas la conception d’un nouvel arbre de recherche. |
Ressources officielles d’intégration
- Documentation développeur — authentification, SDK, quotas, erreurs et comportement des points de terminaison
- Référence API interactive — schémas de requête et de réponse pour les points de terminaison publics
- Spécification OpenAPI — le contrat API anglais lisible par machine
- Guide de l’API de solveur GTO — ce que renvoie l’API de stratégie hébergée
- Python SDK — le client Python officiel typé
- SDK JavaScript / TypeScript — le client officiel typé JavaScript et TypeScript
- Serveur MCP — le serveur d’outils officiel de l’API Pokerai pour les agents compatibles
- llms.txt — le point d’entrée LLM concis pour l’API Pokerai