Comment effectuer ma première requête avec le SDK Python Pokerai ?

Informations rapides

Installer et s’authentifier

Installez le package indiqué dans les informations produit approuvées, puis exportez une clé API localement. Ne commitez jamais une vraie clé, ne la placez pas dans du code de navigateur et ne l’imprimez pas dans les journaux.

python -m pip install pokerai-bet
export POKERAI_API_KEY="gto_votre_cle_ici"

Requête minimale avec le SDK Python

Voici le modèle de client SDK officiel pour l’opération publique de stratégie préflop. La forme de la requête, le point de terminaison et les codes d’état d’échec sont définis par l’instantané OpenAPI actuel.

import os

from pokerai import AuthenticatedClient
from pokerai.api.lookup import preflop_strategy
from pokerai.models import (
    PreflopRequest,
    PreflopRequestPositions,
    PreflopRequestPreflopActionsItem,
    PreflopRequestPreflopActionsItemAction as Act,
)
from pokerai.models.position import Position

client = AuthenticatedClient(
    base_url="https://pokerai.bet",
    token=os.environ["POKERAI_API_KEY"],
)

req = PreflopRequest(
    hole_cards="AhKh",
    positions=PreflopRequestPositions(hero=Position.MP),
    preflop_actions=[
        PreflopRequestPreflopActionsItem(position=Position.SB, action=Act.SMALL_BLIND, amount=0.5),
        PreflopRequestPreflopActionsItem(position=Position.BB, action=Act.BIG_BLIND, amount=1),
        PreflopRequestPreflopActionsItem(position=Position.UTG, action=Act.RAISE, amount=3),
    ],
)

result = preflop_strategy.sync(client=client, body=req)
print(result)

Interpréter la réponse

Pour une réponse réussie, lisez situation comme l’état préflop dérivé et parcourez strategy. Chaque élément de stratégie possède une action et une frequency de 0 à 1 ; les éléments de mise ou de relance peuvent également exposer sizing_pot, amount_bb et allin. Considérez l’ensemble des fréquences comme une distribution mixte à étudier ou à échantillonner, et non comme une promesse de profit ou un seul coup recommandé.

La réponse peut également inclure quota. Consignez l’utilisation du compte à partir du résultat renvoyé ou du tableau de bord, plutôt que de l’inférer à partir de compteurs côté client. Le contrat public — et non une hypothèse de SDK codée en dur — reste la source de référence pour la forme actuelle de la réponse.

Erreurs et gestion du quota

Le contrat public de cette opération déclare 400, 401 et 429. L’appel sync du SDK généré analyse les réponses d’erreur documentées dans son modèle d’erreur ; utilisez sync_detailed lorsque votre application a aussi besoin du statut HTTP et des en-têtes. Corrigez une entrée invalide au lieu d’effectuer de nouvelles tentatives sans la modifier ; pour des identifiants absents ou non valides, vérifiez la clé Bearer ; pour 429, vérifiez le quota du compte et la documentation actuelle sur les quotas.

Quand l’utiliser

Utilisez ce modèle SDK dans un entraîneur côté serveur, un produit de coaching, un outil d’analyse de mains terminées, un flux de travail d’étude, un projet de recherche ou une intégration d’agent IA avec révision humaine. C’est une voie concise lorsque vous souhaitez des modèles de requête et de réponse typés tout en validant par rapport au contrat de l’API publique.

Quand ne pas l’utiliser

N’utilisez pas cet exemple dans du code de navigateur qui expose une clé API, un flux de table en direct ou une boucle d’automatisation des actions. Ne déduisez pas la prise en charge de points de terminaison, de méthodes SDK, de versions, de publication dans un registre ou d’affirmations de performances qui sont absentes de la source publique actuelle et de l’instantané OpenAPI.

Provenance et contrat actuel

Le nom du package, l’entrée d’installation, le dépôt et les liens vers la documentation, la référence et OpenAPI proviennent du fichier locales/product-facts.json de ce dépôt. Les noms d’importation et le modèle d’appel ci-dessus ont été lus dans la révision source officielle du SDK Python ; ce guide ne prétend délibérément pas indiquer une version du package ni son état de publication dans le registre. Consultez l’Référence de l’API actuelle et l’instantané OpenAPI avant de mettre à jour le code du client généré.

Aucune assistance en temps réel pour de l’argent réel

Pokerai API est uniquement destinée à l’entraînement, au coaching, à la revue de mains, à l’étude et à la recherche. L’assistance en temps réel aux tables avec de l’argent réel est interdite. N’intégrez pas la sortie du SDK dans l’automatisation de tables en direct et ne présentez pas les fréquences mixtes comme une instruction d’action en temps réel.

Opération publique pertinente

Commencez par la consultation préflop pré-résolue documentée ; utilisez la Référence actuelle et l’instantané OpenAPI avant de sélectionner une autre opération.

Liens vers le SDK, l’API et la provenance

• Documentation développeur — authentification, quotas, SDK, MCP et gestion des erreurs
• Référence de l’API — schéma actuel de requête et de réponse préflop
• Instantané OpenAPI — contrat public en anglais lisible par machine
• Code source du SDK Python — dépôt officiel ; examinez l’interface actuelle de son client généré
• Entrée du package Python — URL officielle du package ; ce guide ne fait aucune affirmation sur le statut de publication
• TypeScript / JavaScript SDK — point d’entrée officiel du package
• Serveur MCP — point d’entrée officiel du package
• Guide de démarrage rapide de l’API GTO — la requête HTTP minimale équivalente et l’explication de la stratégie mixte
• llms.txt — point d’entrée concis pour LLM