Como executar com segurança uma resolução da API do solver GTO?
Trate uma resolução em tempo real como um ciclo de vida curto: agende-a, consulte sua árvore até que seja possível consultá-la e, em seguida, leia apenas os tokens retornados por essa árvore.
POST /v1/gto/solver, mantenha seu identificador solve e consulte POST /v1/gto/solver/tree até que spot_status seja queryable. Passe o token de um nó retornado para POST /v1/gto/solver/node. Esta página aborda agendamento, consulta e leitura — não a seleção de solver nem o projeto de árvore de pesquisa.Fatos rápidos
| Agendamento | POST /v1/gto/solver requer board, oop_range, ip_range, pot, effective_stack e hero. |
|---|---|
| Sinais assíncronos | O status do agendamento pode ser computing, queryable ou busy; o spot_status da árvore é o sinal de prontidão para leituras. |
| Escopo de leitura | Use o identificador solve apenas com suas chamadas de árvore/liberação e use um token retornado por essa árvore somente como a entrada node para /v1/gto/solver/node. |
| Cota | solve_quota está presente apenas quando uma nova resolução foi acionada. As operações de árvore, nó e liberação opcional são documentadas como gratuitas. |
| Limite do resultado | Um nó legível pode conter strategy ou actions e range_strategy; um status não legível não é uma estratégia. |
1. Agende e mantenha o identificador
Use uma situação personalizada completa e independente no flop, turn ou river. O tamanho do board seleciona a street. Armazene o identificador solve retornado; ele é o identificador para as solicitações posteriores de árvore e liberação.
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"}'Uma resposta de agendamento pode ser computing ou queryable. Se for busy, nenhum identificador solve estará disponível para consulta; trate isso como capacidade do solver, e não como uma resolução concluída. O contrato público não promete tempo de espera nem nível de disponibilidade.
2. Consulte a árvore antes de ler a estratégia
Chame POST /v1/gto/solver/tree com o identificador. Para uma resolução de flop, turn_card é opcional; river_card também é opcional e é combinado com turn_card quando é necessário desambiguar. Não invente nenhum dos campos para uma resolução diferente.
curl -s https://pokerai.bet/v1/gto/solver/tree \
+ -H "Authorization: Bearer $POKERAI_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"solve":"<identificador solve>"}'Continue somente quando spot_status for queryable. computing não é um resultado de estratégia. no_nodes é terminal para a rodada ou o runout consultado, então pare de consultá-lo. expired significa que o identificador não pode mais ser usado e que o spot deve ser agendado novamente.
3. Leia um nó usando seu token da árvore
Uma árvore consultável retorna nós com campos que incluem node, is_hero, status e token. Passe esse token como node; ele não substitui a chave da API nem um identificador reutilizável de resolução. Mantenha os dados de identificador e token fora dos logs do cliente.
curl -s https://pokerai.bet/v1/gto/solver/node \
+ -H "Authorization: Bearer $POKERAI_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"node":"<token desta árvore solve>"}'Um nó do herói pode retornar strategy. Um nó do vilão, ou uma solicitação sem hole_cards, pode retornar actions e range_strategy. Se a resposta do nó informar node_status como computing, expired ou error, não a apresente como estratégia; error pode incluir message.
4. Interprete apenas um nó legível
Um nó legível do herói pode conter strategy. Um nó do vilão, ou uma solicitação sem hole_cards, pode conter actions e range_strategy. Esses campos descrevem o nó retornado; não são uma promessa sobre uma árvore, situação ou formato de jogo diferente.
Se a árvore estiver computing, no_nodes ou expired, interrompa ou reagende conforme documentado, em vez de apresentar um resultado. Para saber se uma API hospedada ou um solver de desktop é a melhor ferramenta de pesquisa, consulte a comparação transparente.
Use somente para treinamento e revisão
Use este ciclo de vida para treinamento offline, coaching, revisão de mãos, estudo e pesquisa. Ele oferece suporte ao gerenciamento de estado de uma resolução enviada, não à entrega de decisões em mesas ao vivo nem a uma alegação de qualidade de estratégia, latência ou desempenho.
A assistência em tempo real em mesas com dinheiro real é proibida. Mantenha os fluxos de agendamento do solver, consulta, estratégia de nós e liberação fora da automação de mesas ao vivo e de prompts de ação durante a mão.
Mapa de endpoints do ciclo de vida
Estas três operações são suficientes para o ciclo de vida descrito aqui; use apenas os campos documentados no contrato OpenAPI atual.
| Endpoint | Função no ciclo de vida | Entrada ou sinal documentado |
|---|---|---|
POST /v1/gto/solver | Agendar | Campos obrigatórios da situação; salve solve e examine status e o solve_quota opcional. |
POST /v1/gto/solver/tree | Consultar | Envie solve; aguarde spot_status: queryable e selecione um token retornado. |
POST /v1/gto/solver/node | Ler | Envie o token da árvore correspondente como node; hole_cards opcional restringe a leitura da estratégia do herói. |
Recursos relacionados
- Documentação para desenvolvedores — autenticação, cotas e fluxo de trabalho do solver
- Referência interativa da API — esquemas atuais de solicitação e resposta
- Snapshot do OpenAPI — o contrato em inglês legível por máquina
- Guia da API do solver GTO — contexto do produto e mapa da superfície da API
- Guia da API de revisão de mãos de poker — posicione a análise do solver em um fluxo de trabalho pós-sessão
- llms.txt — o ponto de entrada conciso de LLM para a Pokerai API