Como executo um fluxo de trabalho de solver GTO?
Crie uma resolução personalizada de flop, turn ou river, consulte repetidamente o estado da sua árvore até que ela possa ser consultada e, em seguida, solicite a estratégia de um nó concluído.
POST /v1/gto/solver, mantenha o identificador solve retornado, consulte POST /v1/gto/solver/tree até que spot_status seja queryable e, em seguida, passe o token retornado de um nó para POST /v1/gto/solver/node.Fatos rápidos
| Fato | Valor |
|---|---|
| Criar | POST /v1/gto/solver agenda uma resolução de flop, turn ou river; o tamanho do board seleciona a street. |
| Disponibilidade | Consulte POST /v1/gto/solver/tree até que spot_status seja queryable. |
| Ler | Envie um token de nó da árvore para POST /v1/gto/solver/node. |
| Cota | Uma nova resolução usa uma cota de resolução; a reutilização em cache, as leituras da árvore e as leituras de nó não consomem cota de resolução. |
| Plano gratuito | 1.000 consultas pré-resolvidas + 25 resoluções em tempo real por mês. |
Quando usar isto
Use este fluxo de trabalho para uma situação personalizada de flop, turn ou river quando precisar enviar o board, as Ranges, o pote, o stack efetivo e a posição do herói. Este é o ciclo de vida de um identificador de resolução enviado, não uma afirmação sobre todos os formatos de pôquer ou a qualidade dos resultados.
Quando não usar isto
Não use para assistência em tempo real com dinheiro real (RTA): a Pokerai API é para treinamento, coaching, revisão de mãos, estudo e pesquisa. Não trate uma resposta computing, expired, no_nodes ou de nó error como uma estratégia concluída.
Solicitação mínima verificável
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"}'Armazene o identificador solve da resposta. Uma resposta pode informar computing ou queryable; somente um novo disparo inclui solve_quota.
Consulte a árvore e, depois, leia um nó concluído
curl -s https://pokerai.bet/v1/gto/solver/tree -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"solve":"<identificador de 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 node de uma árvore queryable>"}'Para um nó do herói, o formato de sucesso documentado tem strategy. Para um nó do vilão, ou quando hole_cards é omitido, a resposta documentada pode fornecer actions e range_strategy. Consuma apenas os campos documentados pelo contrato OpenAPI atual.
Status e tratamento de erros
| Sinal | Significado | O que fazer |
|---|---|---|
computing | A resolução ou o nó ainda está sendo processado. | Consulte a árvore novamente; não solicite a estratégia como se estivesse concluída. |
queryable | A árvore está pronta para inspeção. | Selecione um token de nó retornado e chame /v1/gto/solver/node. |
no_nodes | A rodada ou runout consultado não tem nós de decisão. | Pare de consultar essa rodada ou runout. |
expired | A resolução foi recolhida ou substituída. | Agende uma nova resolução; o identificador antigo não pode ser consultado. |
error | O nó informa um erro de estratégia, opcionalmente com message. | Trate-o como um nó com falha; não o apresente como estratégia. |
HTTP 429 com status: busy | Todos os hosts do solver estão ocupados. | Tente novamente com backoff; isto não é uma cobrança de cota. |
HTTP 503 | O upstream da árvore ou do nó está indisponível. | Trate como transitório e tente novamente com backoff quando apropriado. |
Cota e recursos relacionados
Uma nova resolução consome o contador de resolução em tempo real; a reutilização de resolução em cache e as leituras de árvore/nó do solver são gratuitas. Consulte o tópico de cotas para os contadores mensais atuais.
- Central de documentação — conceitos da API e autenticação.
- Cotas — limites gratuitos e tratamento de
busy. - Referência da API — esquemas atuais das operações do solver.
- Instantâneo do OpenAPI — contrato legível por máquina do ciclo de vida do solver.
- Guia da API do solver GTO — um guia de implementação relacionado.
- Python SDK, TypeScript / JavaScript SDK e servidor MCP — pontos de entrada dos pacotes oficiais.
Real-time assistance at real-money tables is prohibited.