Quando devo usar uma API de solver de poker hospedada em vez de um solver para desktop?
Use uma API de solver hospedada quando seu produto precisar fazer repetidamente uma solicitação de estratégia documentada e sem estado. Use um solver desktop quando sua pesquisa depender de projetar e inspecionar um fluxo de resolução local personalizado.
Fatos comparáveis
| Interface de API hospedada | Solicitações e respostas JSON sem estado, autenticadas por Bearer, documentadas no contrato OpenAPI público |
|---|---|
| Acesso à estratégia hospedada | Consultas pré-resolvidas de preflop e flop, além de resoluções personalizadas sob demanda de flop, turn e river por meio de endpoints documentados |
| Fluxo de trabalho do solver de desktop | Um fluxo de trabalho local de pesquisa para construir uma árvore, escolher abstrações e tamanhos de aposta, executar uma resolução e inspecionar seus resultados |
| Limite de repetibilidade | Uma solicitação de API só é repetível quando quem a chama preserva a solicitação completa, a versão da API ou a versão da estratégia quando houver suporte e a resposta retornada |
| Uso permitido | Treinamento, coaching, análise de mãos, estudo e pesquisa — nunca assistência em tempo real em mesas com dinheiro real |
Quando uma API hospedada de solver é a melhor opção?
Escolha uma API hospedada quando um software precisar de estratégia dentro de um produto, e não dentro da sessão de desktop de um pesquisador: por exemplo, um treinador que avalia uma mão, uma fila de revisão de mãos, um visualizador de Ranges, um serviço de backend ou um agente de IA com revisão humana. O produto pode chamar um endpoint documentado e renderizar as frequências mistas, Ranges, nós ou EVs retornados.
O limite de integração é explícito. Seu aplicativo é responsável pela autenticação, validação de entrada, armazenamento de seus próprios registros de estudo e apresentação. Pokerai API recebe uma situação sem estado e retorna JSON; ela não exige que seu aplicativo distribua um binário de solver nem opere uma árvore de solver local.
Quando um solver de desktop é a melhor opção?
Escolha um solver de desktop quando o trabalho principal for a pesquisa: definir uma nova árvore de jogo, selecionar abstrações e tamanhos de aposta, executar experimentos locais e inspecionar detalhadamente a árvore resultante. Essas escolhas são entradas para uma resolução, não suposições que uma API hospedada possa inferir a partir de uma breve solicitação de produto.
Um fluxo de trabalho desktop também é o local apropriado para comparar configurações de pesquisa antes de publicar um fluxo de trabalho de estudo fixo. Não descreva uma resposta hospedada como equivalente a uma resolução local configurada separadamente, a menos que a configuração completa e os resultados tenham sido preservados e comparados.
Limites de integração e reprodutibilidade
Para um estudo reproduzível com suporte de API, registre o endpoint, o corpo completo da solicitação, a versão da estratégia ou da API quando o endpoint expuser uma, o momento da solicitação e a resposta retornada. Reproduzir apenas uma descrição em linguagem natural de uma situação não basta: posições, stacks, board, linha de ação, opções de sizing e versão podem alterar o resultado.
Para uma resolução sob demanda, mantenha o identificador da resolução e a configuração original ao ler sua árvore, nós e EVs. Consultas de polling ou de nós inspecionam essa resolução; uma nova submissão é uma solicitação de resolução separada. Se você precisar de um artefato de pesquisa durável, mantenha as entradas e saídas exportadas em seu próprio sistema de estudos.
Uso seguro e sem RTA
A Pokerai API destina-se a treinamento offline, coaching, revisão de mãos, estudo e pesquisa. É proibida a assistência em tempo real em mesas com dinheiro real.
Crie controles de produto em torno desse limite: mantenha os recursos de estratégia em contextos de estudo e revisão, exija revisão humana para explicações geradas por agentes e não transforme um fluxo de trabalho de API ou desktop em aconselhamento para jogo ao vivo.
Mapa de integração
Use o contrato público para selecionar uma solicitação da API; use um solver de desktop quando sua tarefa for projetar a própria configuração de pesquisa.
| Interface | Tarefa de produto | Limite |
|---|---|---|
POST /v1/gto/preflop | Avaliar ou exibir uma situação de preflop | Uma solicitação documentada para uma mão, posição e linha de ação; não é um editor local de árvores personalizadas. |
POST /v1/gto/flop/tree | Renderizar um fluxo de trabalho de flop pré-resolvido | Leia a árvore retornada e os tokens de nó para a formação e o board solicitados. |
POST /v1/gto/solver | Enviar uma tarefa de resolução para uma situação personalizada sob demanda | Envie uma configuração documentada e, ao inspecionar essa resolução, mantenha seu identificador e suas entradas. |
POST /v1/gto/solver/tree | Inspecionar uma resolução concluída | Consulte repetidamente e leia a resolução enviada; ela não substitui o projeto de uma nova árvore de pesquisa. |
Recursos oficiais de integração
- Documentação para desenvolvedores — autenticação, SDKs, cotas, erros e comportamento dos endpoints
- Referência interativa da API — esquemas de solicitação e resposta para os endpoints públicos
- Especificação OpenAPI — o contrato de API em inglês legível por máquina
- Guia da API do solver GTO — o que a API de estratégia hospedada retorna
- Python SDK — o cliente Python tipado oficial
- JavaScript / TypeScript SDK — o cliente oficial tipado para JavaScript e TypeScript
- Servidor MCP — o servidor oficial de ferramentas da API Pokerai para agentes compatíveis
- llms.txt — o ponto de entrada conciso para LLM da API Pokerai