Como faço minha primeira solicitação com o SDK Pokerai para Python?

Fatos rápidos

Instale e autentique-se

Instale o pacote indicado nas informações aprovadas do produto e, em seguida, exporte uma chave de API localmente. Não faça commit de uma chave real, não a coloque no código do navegador nem a imprima em logs.

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

Solicitação mínima com o SDK Python

Este é o padrão oficial de cliente do SDK para a operação pública de estratégia pré-flop. O formato da solicitação, o endpoint e os códigos de status de insucesso são definidos pelo snapshot atual do OpenAPI.

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)

Interprete a resposta

Para uma resposta bem-sucedida, leia situation como o estado pré-flop derivado e percorra strategy. Cada item de estratégia tem uma action e uma frequency de 0 a 1; itens de aposta ou aumento também podem expor sizing_pot, amount_bb e allin. Trate o conjunto de frequências como uma distribuição mista para estudar ou amostrar, não como uma promessa de lucro ou uma única jogada recomendada.

A resposta também pode incluir quota. Registre o uso da conta a partir do resultado retornado ou do painel, em vez de inferi-lo a partir de contadores do lado do cliente. O contrato público — e não uma suposição codificada do SDK — continua sendo a fonte do formato atual da resposta.

Erros e tratamento de cota

O contrato público desta operação declara 400, 401 e 429. A chamada sync do SDK gerado analisa as respostas de erro documentadas e as converte em seu modelo de erro; use sync_detailed quando sua aplicação também precisar do status HTTP e dos cabeçalhos. Corrija uma entrada inválida em vez de tentar novamente sem alterá-la; para credenciais ausentes ou inválidas, verifique a chave Bearer; para 429, verifique a cota da conta e a documentação de cotas atual.

Quando usar

Use este padrão de SDK em um treinador do lado do servidor, produto de coaching, ferramenta de revisão de mãos concluídas, fluxo de estudo, projeto de pesquisa ou integração de agente de IA com revisão humana. É um caminho conciso quando você quer modelos tipados de solicitação e resposta e ainda valida o contrato público da API.

Quando não usá-lo

Não use este exemplo em código de navegador que exponha uma chave de API, um feed de mesa ao vivo ou um loop de automação de ações. Não presuma suporte para endpoints, métodos do SDK, versões, publicação em registro ou alegações de desempenho ausentes da fonte pública atual e do snapshot do OpenAPI.

Proveniência e contrato atual

O nome do pacote, a entrada de instalação, o repositório e os links de Documentação, Referência e OpenAPI vêm do locales/product-facts.json deste repositório. Os nomes de importação e o padrão de chamada acima foram lidos na revisão de origem do SDK Python oficial; este Guia deliberadamente não declara uma versão do pacote nem o estado de publicação no registro. Consulte a Referência da API atual e o snapshot do OpenAPI antes de atualizar o código do cliente gerado.

Sem RTA com dinheiro real

A Pokerai API destina-se apenas a treinamento, coaching, revisão de mãos, estudo e pesquisa. A assistência em tempo real em mesas com dinheiro real é proibida. Mantenha a saída do SDK fora da automação de mesas em jogo e não apresente frequências mistas como uma instrução de ação em tempo real.

Operação pública relevante

Comece pela consulta pré-flop pré-resolvida documentada; use a Referência e o snapshot OpenAPI atuais antes de selecionar outra operação.

Links de SDK, API e procedência

• Documentação para desenvolvedores — autenticação, cotas, SDK, MCP e tratamento de erros
• Referência da API — esquema atual de solicitação e resposta preflop
• Snapshot do OpenAPI — contrato público em inglês legível por máquina
• Código-fonte do SDK Python — repositório oficial; inspecione a interface atual do cliente gerado
• Página do pacote Python — URL oficial do pacote; este Guia não faz nenhuma afirmação sobre o status de lançamento
• SDK para TypeScript / JavaScript — ponto de entrada oficial do pacote
• Servidor MCP — ponto de entrada oficial do pacote
• Início rápido da API GTO — a solicitação HTTP mínima equivalente e a explicação da estratégia mista
• llms.txt — ponto de entrada conciso para LLM