¿Cuándo debo usar una API de solver de póker alojada en lugar de un solver de escritorio?
Use una API de solucionador alojada cuando su producto necesite una solicitud de estrategia documentada y sin estado que pueda realizar repetidamente. Use un solucionador de escritorio cuando su investigación dependa de diseñar e inspeccionar un flujo de trabajo de resolución local personalizado.
Datos comparables
| Interfaz de API alojada | Solicitudes y respuestas JSON sin estado autenticadas mediante Bearer, documentadas en el contrato público de OpenAPI |
|---|---|
| Acceso a estrategias alojadas | Consultas pre-resueltas de preflop y flop, además de resoluciones personalizadas bajo demanda de flop, turn y river a través de endpoints documentados |
| Flujo de trabajo con solver de escritorio | Un flujo de trabajo de investigación local para construir un árbol, elegir abstracciones y tamaños, ejecutar una resolución e inspeccionar sus resultados |
| Límite de repetibilidad | Una solicitud de API solo es repetible cuando quien la realiza conserva la solicitud completa, la versión de la API o de la estrategia cuando se admita, y la respuesta devuelta |
| Uso permitido | Entrenamiento, coaching, revisión de manos, estudio e investigación; nunca asistencia en tiempo real en mesas con dinero real |
¿Cuándo encaja mejor una API alojada de solucionador?
Elija una API alojada cuando el software necesite estrategia dentro de un producto en vez de dentro de la sesión de escritorio de un investigador: por ejemplo, un entrenador que evalúa una mano, una cola de revisión de manos, un visualizador de rangos, un servicio de backend o un agente de IA con revisión humana. El producto puede llamar a un endpoint documentado y representar las frecuencias mixtas, los rangos, los nodos o los EV devueltos.
El límite de la integración es explícito. Su aplicación es responsable de la autenticación, la validación de entradas, el almacenamiento de sus propios registros de estudio y la presentación. Pokerai API recibe una situación sin estado y devuelve JSON; no requiere que su aplicación distribuya un binario de solucionador ni opere un árbol de solucionador local.
¿Cuándo es un solver de escritorio la mejor opción?
Elige un solver de escritorio cuando el trabajo principal sea la investigación: definir un árbol de juego novedoso, seleccionar abstracciones y tamaños de apuesta, realizar experimentos locales e inspeccionar en detalle el árbol resultante. Esas decisiones son entradas para una resolución, no supuestos que una API alojada pueda inferir a partir de una breve solicitud de producto.
Un flujo de trabajo de escritorio también es el lugar apropiado para comparar configuraciones de investigación antes de publicar un flujo de trabajo de estudio fijo. No describa una respuesta alojada como equivalente a una resolución local configurada por separado, a menos que se hayan conservado y comparado la configuración completa y los resultados.
Límites de integración y reproducibilidad
Para un estudio reproducible respaldado por una API, registre el endpoint, el cuerpo completo de la solicitud, la versión de la estrategia o de la API cuando el endpoint exponga una, la hora de la solicitud y la respuesta devuelta. Reproducir solo una descripción en lenguaje natural de una situación no es suficiente: las posiciones, los stacks, el board, la línea de acción, las opciones de tamaño y la versión pueden cambiar el resultado.
Para una resolución bajo demanda, conserve el identificador de resolución y la configuración original mientras lee su árbol, nodos y EVs. Los sondeos o las lecturas de nodos inspeccionan esa resolución; un nuevo envío es una solicitud de resolución independiente. Si necesita un artefacto de investigación duradero, conserve las entradas y salidas exportadas en su propio sistema de estudio.
Uso seguro y sin RTA
Pokerai API es para entrenamiento sin conexión, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real.
Diseñe los controles del producto en torno a ese límite: mantenga las funciones de estrategia en contextos de estudio y revisión, exija revisión humana para las explicaciones generadas por agentes y no convierta una API o un flujo de trabajo de escritorio en consejos para el juego en vivo.
Mapa de integración
Utiliza el contrato público para seleccionar una solicitud de API; utiliza un solver de escritorio cuando tu tarea sea diseñar la propia configuración de investigación.
| Superficie | Tarea del producto | Límite |
|---|---|---|
POST /v1/gto/preflop | Evalúa o muestra una situación de preflop | Una solicitud documentada para una mano, posición y línea de acción; no un editor local personalizado de árboles. |
POST /v1/gto/flop/tree | Renderizar un flujo de trabajo de flop pre-resuelto | Lee el árbol devuelto y los tokens de nodo para la formación y el tablero solicitados. |
POST /v1/gto/solver | Enviar una situación personalizada bajo demanda | Envíe una configuración documentada y luego conserve su identificador y entradas mientras inspecciona esa resolución. |
POST /v1/gto/solver/tree | Inspeccionar una resolución completada | Consulta periódicamente y lee la resolución enviada; no sustituye el diseño de un nuevo árbol de investigación. |
Recursos oficiales de integración
- Documentación para desarrolladores — autenticación, SDKs, cuotas, errores y comportamiento de los endpoints
- Referencia interactiva de la API — esquemas de solicitud y respuesta para los endpoints públicos
- Especificación de OpenAPI — el contrato de API en inglés legible por máquina
- Guía de la API del solucionador GTO — lo que devuelve la API de estrategia alojada
- Python SDK — el cliente oficial de Python con tipado
- SDK de JavaScript / TypeScript — el cliente oficial con tipado para JavaScript y TypeScript
- Servidor MCP — el servidor de herramientas oficial de la API de Pokerai para agentes compatibles
- llms.txt — el punto de entrada conciso a Pokerai API para LLM