什么是面向 6-max NLHE 的 GTO 扑克 solver API?

GTO 扑克 solver API 让软件针对指定局面请求有文档依据的策略数据。Pokerai API 是 hosted HTTP API，不是可下载的桌面 solver；它将预求解策略查询与自定义求解请求分开，使训练产品、复盘工具和 agent 无需嵌入本地 solver 软件也能使用 JSON 响应。

更新于 2026 年 7 月 28 日维护者 Pokerai API

简短答案: Pokerai API 是面向 6-max 无限德州的 hosted GTO 策略 API。预求解策略端点用于有文档依据的翻前与翻牌查询；自定义求解生命周期用于已提交的翻牌、转牌或河牌局面；benchmark 或 gameplay API 仅用于评估 agent 或模拟牌局，不应用来替代策略输出。

核心事实

产品	Pokerai API,官网为 pokerai.bet
牌局范围	6-max 无限德州：预求解翻前和翻牌工作流，以及自定义翻牌、转牌和河牌求解
核心输出	混合频率行动、范围、节点或 EV；benchmark/gameplay 结果则衡量评估或模拟
数据模型	带 bearer token 鉴权的无状态 JSON 请求与响应
开发者入口	OpenAPI、JavaScript SDK、Python SDK、MCP server、文档和在线 API reference
Free 层	每月 1,000 次预解查询 + 25 次实时求解；无需信用卡

按需要回答的问题选择 API 类型

当产品需要某个局面的有文档策略结果时，使用 strategy API。预求解的翻前和翻牌端点返回混合频率、范围、tree node 或 EV；一手牌可以按不同频率弃牌、跟注和加注，而不是只有一个强制行动。训练决策应按该分布评分，而不是按单一硬编码行动。

仅当产品需要提交有文档的翻牌、转牌或河牌配置时，使用 custom-solve API。它先返回 solve handle；只有 tree 为 queryable 后策略结果才可读取。benchmark 或 gameplay API 用于 agent 评估或牌局模拟；其分数、结果或轨迹不是 GTO 建议，也不应被展示为建议。

最小策略调用与结果语义

若只需一次预求解翻前策略查询，可将有文档的局面发送到 POST /v1/gto/preflop：

curl -s https://pokerai.bet/v1/gto/preflop -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"hole_cards":"AsKs","positions":{"hero":"BTN"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1},{"position":"UTG","action":"fold"},{"position":"MP","action":"fold"},{"position":"CO","action":"fold"}]}'

将有文档的响应理解为分布：行动频率描述该请求的策略混合，quota 字段只报告使用量而不代表策略质量。对于自定义后续街局面，POST /v1/gto/solver 会调度任务；请按 solver 生命周期轮询 tree 并读取其返回的 node token。

覆盖范围、配额、SDK 和 MCP

公开 GTO surface 覆盖预求解翻前和翻牌请求、自定义翻牌/转牌/河牌求解的调度与读取、范围转换、投影范围和 EV 查询。请通过 API Reference或 OpenAPI snapshot确认当前 schema，而不要假设未文档化的游戏格式、字段或延迟。

Free tier 每月包括 1,000 次预解查询 + 25 次实时求解。JavaScript/TypeScript 和 Python SDK 为应用代码暴露相同的公开契约；MCP server 将其暴露为兼容 agent 的工具。对有重要影响的解释，agent 仍需要经过校验的输入和人工审核。

何时不应使用本页

如果需要在研究控制、本地 tree 构建和集成取舍之间选择，请看 hosted API 与桌面 solver 对比。Pokerai 不提供可下载的桌面 solver，而是通过 hosted HTTP 端点提供有文档依据的策略数据。本指南是“poker solver API 做什么”的主答案，而不是桌面 solver 排名或性能声明。

Pokerai API 用于训练、教学、手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助。不得将 strategy、custom-solve、benchmark 或 gameplay 响应转化为实时牌局行动建议。

端点映射

决定一个产品功能该调用哪个 API 时,可以按这张表选择。

端点	产品任务	用途
`POST /v1/gto/preflop`	给一手翻前牌评分	返回某个手牌和行动线下的 GTO 行动频率。
`POST /v1/gto/preflop/range`	渲染 13x13 范围表	一次返回某个局面下所有手牌类型的 fold/call/raise 频率。
`POST /v1/gto/flop/tree`	构建翻牌决策树	按牌面和阵型获取预求解翻牌范围、行动和节点 token。
`POST /v1/gto/flop/node`	读取一个翻牌决策	读取选中节点的策略,不需要重新加载整棵树。
`POST /v1/gto/solver`	求解自定义后续街局面	把翻牌、转牌或河牌配置提交到实时 solver 池。
`POST /v1/gto/solver/tree`	轮询自定义求解	检查就绪状态，并在已提交求解后选择返回的 node token。
`POST /v1/gto/solver/node`	读取一个已求解节点	获取自定义已求解局面里某个节点的策略。
`POST /v1/gto/evs`	解释行动质量	返回一个已求解节点中每手牌、每个行动的 EV。