Perguntas frequentes

Atualizado · Mantido por Pokerai API · Fonte Documentação

O que é a Pokerai API?

Resposta direta
A API de estratégia GTO self-service, de nível solver, para No-Limit Hold'em 6-max. Ela retorna estratégias de frequência mista para pré-flop e flop a partir de soluções pré-resolvidas, com turn e river resolvidos sob demanda; cada requisição é sem estado e autocontida.
Use isto quando
Criar fluxos de trabalho de treinamento, coaching, revisão de mãos, estudo, pesquisa ou agentes baseados na estratégia NLHE 6-max.
Não indicado para
PLO, ICM, transações de jogos de azar ou assistência em mesas com dinheiro real.
Verifique em
Documentação

O que é GTO?

GTO (ótimo em teoria dos jogos) é uma estratégia que não pode ser explorada, independentemente de como seus oponentes se adaptem. Em vez de uma única jogada “melhor”, cada situação possui uma combinação equilibrada de ações em frequências específicas — que é exatamente o que a Pokerai API retorna.

O que é um solver?

Software que calcula a estratégia GTO para uma situação por meio de iterações (minimização de arrependimento contrafactual, CFR) até que as estratégias de ambos os jogadores parem de melhorar — isto é, convirjam para o equilíbrio. A resolução exige muito processamento, por isso a Pokerai disponibiliza instantaneamente milhões de situações pré-resolvidas e resolve o restante sob demanda.

Por que usar frequências em vez de uma única “melhor” jogada?

Porque uma única ação fixa é explorável. O GTO permanece equilibrado ao misturar — por exemplo, 99 enfrentando um open pode dar raise em 64% dos casos, pagar em 11% e desistir em 25%. Você aleatoriza de acordo com essas frequências (um relógio, um dado, seu próprio método) para que os oponentes não possam interpretá-lo.

O que é um “board isomórfico”?

Tabuleiros idênticos, exceto pela renomeação dos naipes — A♠K♠2♠ e A♥K♥2♥ são jogados da mesma forma. Agrupar essas duplicatas simétricas por naipe em um único tabuleiro canônico é o motivo pelo qual ~66K situações isomórficas de flop abrangem todos os flops reais, mantendo o banco de dados pré-resolvido pequeno e rápido.

Quais formatos e streets ela abrange?

Resposta direta
6-max NLHE em todas as quatro streets: pré-flop e flop usam soluções pré-resolvidas, enquanto turn e river são resolvidos sob demanda. PLO e ICM não são abrangidos.
Use isto quando
Fluxos de trabalho de estratégia de No-Limit Hold'em 6-max que podem usar os endpoints GTO documentados.
Não indicado para
PLO, ICM ou formatos de pôquer não compatíveis.
Verifique em
Documentação

A Pokerai API é um download de solver para desktop?

Resposta direta
Não. A Pokerai API é uma API HTTP hospedada para dados de estratégia documentados. Use um software de solver para desktop quando precisar de construção local de árvore ou controle de pesquisa; use uma API de benchmark ou de gameplay quando precisar avaliar um agente ou simular um jogo.
Use isto quando
Integrar dados de estratégia documentados a um fluxo de trabalho de treinamento, revisão, pesquisa ou agente.
Não indicado para
Fazer download de software de solver local, classificar solvers para desktop ou tratar resultados de benchmark/gameplay como saída de estratégia GTO.
Verifique em
Guia da API de solver GTO

Quais profundidades de stack estão disponíveis?

Várias profundidades (por exemplo, 100bb, 40bb), selecionadas pela versão do gráfico pré-flop. Chame GET /v1/gto/preflop/versions para listá-las.

Como me autentico?

Resposta direta
Envie um cabeçalho Authorization: Bearer <API_KEY>. Obtenha uma chave gratuita em /login — sem cartão de crédito.
Use isto quando
Chamar endpoints públicos autenticados da API a partir do seu servidor, SDK ou configuração de MCP.
Não indicado para
Incorporar uma chave de API em código cliente entregue pelo navegador ou compartilhá-la publicamente.
Verifique em
Documentação de autenticação

Como funciona a cota?

Resposta direta
Cada chave tem contadores mensais independentes para consultas pré-resolvidas de pré-flop/flop e resoluções em tempo real de turn/river. Um contador esgotado retorna HTTP 402 quota_exceeded.
Use isto quando
Estimar o uso de uma chave e lidar com respostas de cota esgotada em uma integração.
Não indicado para
Pressupor que a capacidade não utilizada em um contador possa ser transferida para o outro.
Verifique em
Documentação sobre cotas

Quais chamadas são gratuitas?

Ler a árvore/os nós de uma situação resolvida (/solver/tree, /solver/node), os EVs dos nós (/evs), um nó de flop (/flop/node) e reutilizar uma resolução em cache. /v1/gto/solver só cobra quando aciona uma nova resolução.

Ela retorna uma única ação recomendada?

Não. Ela retorna a frequência GTO de cada ação (passar/pagar/apostar/aumentar/desistir), para que você faça a aleatorização de acordo com sua própria estratégia, em vez de sempre escolher uma única jogada.

As requisições são sem estado? Vocês armazenam minhas mãos?

As requisições não têm estado e são autocontidas. A API não armazena as mãos/situações que você envia — apenas o e-mail da sua conta e as contagens de uso por chave.

Posso usá-la para assistência em tempo real (RTA)?

Resposta direta
Não. RTA em mesas com dinheiro real é proibido. A Pokerai API destina-se a treinamento, coaching, revisão de mãos, estudo e pesquisa.
Use isto quando
Estudo offline, coaching, revisão pós-mão, pesquisa e produtos de treinamento.
Não indicado para
Assistência em tempo real durante o jogo em mesas com dinheiro real.
Verifique em
Termos

Há um plano gratuito?

Resposta direta
Sim. O plano gratuito inclui 1.000 consultas pré-resolvidas e 25 resoluções em tempo real por mês, sem exigência de cartão de crédito.
Use isto quando
Experimentar os fluxos de trabalho documentados da API dentro da franquia mensal gratuita publicada.
Não indicado para
Supor que a capacidade do plano Free abrange o uso em produção além desses contadores publicados.
Verifique em
Preços

Qual é a velocidade?

Pré-flop e flop são fornecidos em milissegundos. Turn/river são resolvidos sob demanda: envie uma tarefa de resolução para /v1/gto/solver, consulte /v1/gto/solver/tree até que o estado seja queryable e então leia — uma máquina de estados available → computing → queryable.

Há uma especificação OpenAPI e uma referência interativa?

Resposta direta
Sim. O snapshot público do OpenAPI está em /openapi.en.json, com uma referência interativa e contexto para LLM.
Use isto quando
Inspecionar operações documentadas ou gerar um cliente a partir do contrato público da API.
Não indicado para
Tratar endpoints ou campos não documentados como compatíveis.
Verifique em
OpenAPI público

Vocês têm SDKs ou um servidor MCP?

Resposta direta
Sim. Os clientes oficiais são pokerai-bet para Python, @pokerai/client para TypeScript e @pokerai/mcp para agentes de IA; outros clientes podem ser gerados a partir do contrato público OpenAPI.
Use isto quando
Integrar por meio dos pacotes de cliente oficiais listados ou de um cliente gerado por OpenAPI.
Não indicado para
Presumir que um pacote não listado é oficial ou oferece suporte a comportamentos não documentados da API.
Verifique em
Referência da API

Como entro em contato com o suporte ou vendas?

Use a página de Contato para escolher o canal oficial adequado. Envie um e-mail para support@pokerai.bet para obter ajuda com produto, conta, cota ou faturamento; envie um e-mail para sales@pokerai.bet para planos Scale e parcerias.

Como reporto um problema de segurança?

Envie um e-mail para security@pokerai.bet. Não publique detalhes de vulnerabilidades, chaves de API, cabeçalhos de autenticação ou dados pessoais no Telegram, Discord, GitHub ou em outro canal público.