常见问题
更新于 · 维护方 Pokerai API · 来源 文档
Pokerai API 是什么?
- 直接回答
- 面向 6-max 无限德州的自助式、solver 级 GTO 策略 API。preflop 与 flop 返回预解的混合频率策略，turn 与 river 按需求解；每个请求无状态且自包含。
- 适用场景
- 围绕 6-max NLHE 策略构建陪练、教学、复盘、学习、研究或 agent 工作流。
- 不适用于
- PLO、ICM、赌博交易或真钱牌桌实时辅助。
什么是 GTO?
GTO(博弈论最优)是一种无论对手怎么调整都无法被剥削的策略。它不给单一「最优手」,而是每个局面给一组按特定频率平衡的动作——这正是 Pokerai API 返回的。
什么是求解器(solver)?
通过迭代(反事实遗憾最小化 CFR)计算某局面 GTO 策略的软件,直到双方策略不再改进、收敛到均衡。求解很耗算力,所以 Pokerai 把数百万预解局面即时返回,其余按需求解。
为什么给频率、而不是单一「最优手」?
因为固定单一动作会被剥削。GTO 靠混合保持平衡——比如 99 面对开局,可能 raise 64%、call 11%、fold 25%。你按这些频率随机化(看秒表、掷骰子、自定规则),对手就读不出你。
什么是「同构牌面」(isomorphic board)?
花色重命名后等价的牌面——A♠K♠2♠ 和 A♥K♥2♥ 打法完全一样。把这些花色对称的重复折叠成一个规范牌面,就是为什么约 66K 个同构 flop 局面能覆盖所有真实 flop,让预解库又小又快。
覆盖哪些格式和街?
- 直接回答
- 覆盖 6-max 无限德州四条街：preflop 与 flop 使用预解方案，turn 与 river 按需求解。暂不覆盖 PLO 和 ICM。
- 适用场景
- 可使用已文档化 GTO 端点的 6-max 无限德州策略工作流。
- 不适用于
- PLO、ICM 或未支持的扑克格式。
Pokerai API 是可下载的桌面 solver 吗?
- 直接回答
- 不是。Pokerai API 是提供有文档策略数据的 hosted HTTP API。需要本地 tree 构建或研究控制时使用桌面 solver；需要评估 agent 或模拟牌局时使用 benchmark 或 gameplay API。
- 适用场景
- 将有文档依据的策略数据集成到陪练、复盘、研究或 agent 工作流。
- 不适用于
- 下载本地 solver 软件、给桌面 solver 排名，或将 benchmark/gameplay 结果视为 GTO 策略输出。
有哪些筹码深度?
多种深度(如 100bb、40bb),按 preflop 图表版本选择。GET /v1/gto/preflop/versions 可列出。
如何鉴权?
- 直接回答
- 携带
Authorization: Bearer <API_KEY> 请求头。在 /login 可免费获取 Key，无需信用卡。 - 适用场景
- 从服务端、SDK 或 MCP 配置调用需要鉴权的公开 API 端点。
- 不适用于
- 将 API Key 放进浏览器下发的客户端代码或公开分享。
配额怎么算?
- 直接回答
- 每个 Key 的预解 preflop/flop 查询与实时 turn/river 求解分别按月计数。任一计数耗尽时返回
HTTP 402 quota_exceeded。
- 适用场景
- 估算单个 Key 的用量，并在集成中处理配额耗尽响应。
- 不适用于
- 把一个计数器的剩余额度转移给另一个计数器。
哪些调用免费?
读已解局面的树/节点(/solver/tree、/solver/node)、节点 EV(/evs)、flop 节点(/flop/node),以及复用已缓存的解。/v1/gto/solver 仅在触发新求解时扣费。
它返回单一推荐动作吗?
不。它返回每个动作的 GTO 频率(check/call/bet/raise/fold),你按自己的策略随机化,而非永远取某一手。
请求无状态吗?会存我的牌吗?
无状态、自包含。不存你发送的牌局/局面——只保留账户邮箱与每个 Key 的用量计数。
能用于实时辅助(RTA)吗?
- 直接回答
- 不能。禁止真钱牌桌实时辅助。Pokerai API 面向陪练、教学、复盘、学习与研究。
- 适用场景
- 离线学习、教学、牌局后复盘、研究和陪练产品。
- 不适用于
- 在真钱牌桌进行中的实时辅助。
有免费层吗?
- 直接回答
- 有。Free 层每月包含 1,000 次预解查询和 25 次实时求解，无需信用卡。
- 适用场景
- 在公布的 Free 月度额度内试用已文档化的 API 工作流。
- 不适用于
- 假设 Free 额度可覆盖超出这些公开计数器的生产用量。
有多快?
preflop 与 flop 毫秒级返回。turn/river 按需求解:提交到 /v1/gto/solver,轮询 /v1/gto/solver/tree 到 queryable 再读——available → computing → queryable 状态机。
有 OpenAPI 与交互式参考吗?
- 适用场景
- 查看已文档化操作，或从公开 API contract 生成客户端。
- 不适用于
- 把未文档化端点或字段视为受支持功能。
有 SDK 或 MCP server 吗?
- 直接回答
- 有。官方客户端包括 Python 的 pokerai-bet、TypeScript 的 @pokerai/client，以及面向 AI agent 的 @pokerai/mcp；也可由公开 OpenAPI contract 生成其他客户端。
- 适用场景
- 通过列出的官方客户端包或 OpenAPI 生成的客户端进行集成。
- 不适用于
- 假定未列出的包是官方包，或支持未文档化的 API 行为。
如何报告安全问题?
请发送邮件至 security@pokerai.bet。不要在 Telegram、Discord、GitHub 或其他公开渠道发布漏洞细节、API Key、鉴权 Header 或个人数据。