Preguntas frecuentes

Actualizado · Mantenido por Pokerai API · Fuente Documentación

¿Qué es Pokerai API?

Respuesta directa
La API de estrategia GTO de autoservicio, de calidad de solver, para 6-max No-Limit Hold'em. Devuelve estrategias de frecuencia mixta para preflop y flop a partir de soluciones preresueltas, con turn y river resueltos bajo demanda; cada solicitud no tiene estado y es autosuficiente.
Úsalo cuando
Creación de flujos de trabajo de entrenamiento, coaching, revisión de manos, estudio, investigación o agentes en torno a la estrategia NLHE 6-max.
No para
PLO, ICM, transacciones de juego ni asistencia en mesas con dinero real.
Verificar en
Documentación

¿Qué es GTO?

GTO (óptimo según la teoría de juegos) es una estrategia que no puede ser explotada sin importar cómo se ajusten tus oponentes. En lugar de un único movimiento «mejor», cada situación tiene una combinación equilibrada de acciones a frecuencias específicas, que es exactamente lo que devuelve Pokerai API.

¿Qué es un solver?

Software que calcula la estrategia GTO para una situación mediante iteraciones (minimización de arrepentimiento contrafactual, CFR) hasta que las estrategias de ambos jugadores dejan de mejorar; es decir, convergen al equilibrio. La resolución requiere mucho cómputo, por lo que Pokerai ofrece al instante millones de situaciones preresueltas y resuelve el resto bajo demanda.

¿Por qué usar frecuencias en lugar de un único movimiento «mejor»?

Porque una única acción fija es explotable. GTO se mantiene equilibrado mezclando — por ejemplo, 99 frente a una apertura podría subir un 64%, pagar un 11% y retirarse un 25%. Aleatorizas según esas frecuencias (un reloj, un dado o tu propio método) para que los oponentes no puedan leerte.

¿Qué es un «board isomorfo»?

Boards idénticos salvo por el cambio de palos — A♠K♠2♠ y A♥K♥2♥ se juegan igual. Reducir estos duplicados simétricos por palo a un único board canónico es la razón por la que ~66K situaciones de flop isomorfas cubren todos los flops reales y mantienen la base de datos preresuelta pequeña y rápida.

¿Qué formatos y calles cubre?

Respuesta directa
6-max NLHE en las cuatro calles: preflop y flop utilizan soluciones precalculadas, mientras que turn y river se resuelven bajo demanda. PLO e ICM no están cubiertos.
Úsalo cuando
Flujos de trabajo de estrategia de 6-max No-Limit Hold'em que pueden utilizar los endpoints GTO documentados.
No para
PLO, ICM u otros formatos de póker no compatibles.
Verificar en
Documentación

¿Es Pokerai API una descarga de solver de escritorio?

Respuesta directa
No. Pokerai API es una API HTTP alojada para datos de estrategia documentados. Usa software de solver de escritorio cuando necesites construir árboles localmente o controlar la investigación; usa una API de benchmark o de juego cuando necesites evaluar un agente o simular una partida.
Úsalo cuando
Integración de datos de estrategia documentados en un flujo de trabajo de entrenamiento, revisión, investigación o agentes.
No para
Descargar software de solver local, clasificar solvers de escritorio o tratar los resultados de benchmarks o de partidas simuladas como resultados de estrategia GTO.
Verificar en
Guía de la API del solver GTO

¿Qué profundidades de stack están disponibles?

Varias profundidades (p. ej., 100bb, 40bb), seleccionadas mediante la versión del gráfico preflop. Llame a GET /v1/gto/preflop/versions para enumerarlas.

¿Cómo me autentico?

Respuesta directa
Envía un encabezado Authorization: Bearer <API_KEY>. Obtén una clave gratuita en /login — sin tarjeta de crédito.
Úsalo cuando
Llamar a endpoints públicos de API autenticados desde tu servidor, SDK o configuración MCP.
No para
Incrustar una clave de API en código cliente enviado al navegador o compartirla públicamente.
Verificar en
Documentación de autenticación

¿Cómo funciona la cuota?

Respuesta directa
Cada clave tiene contadores mensuales independientes para consultas preflop/flop presueltas y solves de turn/river en tiempo real. Un contador agotado devuelve HTTP 402 quota_exceeded.
Úsalo cuando
Estimar el uso de una clave y gestionar respuestas de cuota agotada en una integración.
No para
Suponer que la capacidad no utilizada de un contador puede transferirse al otro.
Verificar en
Documentación de cuotas

¿Qué llamadas son gratuitas?

Leer el árbol/nodos de una situación resuelta (/solver/tree, /solver/node), los EV de los nodos (/evs), un nodo de flop (/flop/node) y reutilizar una resolución almacenada en caché. /v1/gto/solver solo cobra cuando activa una nueva resolución.

¿Devuelve una única acción recomendada?

No. Devuelve la frecuencia GTO de cada acción (check/call/bet/raise/fold), por lo que aleatorizas según tu propia estrategia en lugar de realizar siempre una misma jugada.

¿Las solicitudes no tienen estado? ¿Guardan mis manos?

Las solicitudes no tienen estado y son autosuficientes. La API no almacena las manos/situaciones que envías — solo el correo electrónico de tu cuenta y los recuentos de uso por clave.

¿Puedo usarlo para asistencia en tiempo real (RTA)?

Respuesta directa
No. El RTA en mesas con dinero real está prohibido. Pokerai API es para entrenamiento, coaching, revisión de manos, estudio e investigación.
Úsalo cuando
Estudio sin conexión, coaching, revisión posterior a la mano, investigación y productos de entrenamiento.
No para
Asistencia en tiempo real durante el juego en mesas con dinero real.
Verificar en
Términos

¿Hay un plan gratuito?

Respuesta directa
Sí. El nivel Free incluye 1.000 consultas prerresueltas y 25 resoluciones en tiempo real al mes, sin necesidad de tarjeta de crédito.
Úsalo cuando
Probar los flujos de trabajo de la API documentados dentro de la asignación mensual Free publicada.
No para
Suponer que la capacidad gratuita cubre el uso de producción más allá de esos contadores publicados.
Verificar en
Precios

¿Qué tan rápido es?

Preflop y flop se sirven en milisegundos. Turn/river se resuelven bajo demanda: envía a /v1/gto/solver, consulta /v1/gto/solver/tree hasta que se pueda consultar y luego lee — una máquina de estados disponible → calculando → consultable.

¿Hay una especificación OpenAPI y una referencia interactiva?

Respuesta directa
Sí. La instantánea pública de OpenAPI está en /openapi.en.json, con una referencia interactiva y contexto de LLM.
Úsalo cuando
Inspeccionar operaciones documentadas o generar un cliente a partir del contrato público de la API.
No para
Considerar que los endpoints o campos no documentados son compatibles.
Verificar en
OpenAPI público

¿Tienen SDK o un servidor MCP?

Respuesta directa
Sí. Los clientes oficiales son pokerai-bet para Python, @pokerai/client para TypeScript y @pokerai/mcp para agentes de IA; se pueden generar otros clientes a partir del contrato público de OpenAPI.
Úsalo cuando
Integrar mediante los paquetes de cliente oficiales indicados o un cliente generado por OpenAPI.
No para
Suponer que un paquete no incluido en la lista es oficial o admite comportamientos de API no documentados.
Verificar en
Referencia de la API

¿Cómo contacto con soporte o ventas?

Usa la página de contacto para elegir el canal oficial adecuado. Envía un correo a support@pokerai.bet para obtener ayuda sobre el producto, la cuenta, la cuota o la facturación; envía un correo a sales@pokerai.bet para los planes Scale y las asociaciones.

¿Cómo notifico un problema de seguridad?

Envía un correo a security@pokerai.bet. No publiques detalles de vulnerabilidades, claves de API, encabezados de autenticación ni datos personales en Telegram, Discord, GitHub ni en ningún otro canal público.