本页内容

常见问题

更新于 · 维护方 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 策略输出。
可验证来源
GTO solver API 指南

有哪些筹码深度?

多种深度(如 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 429,错误码为 quota_exceeded(预解)或 solve_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 层每月包含 10 次预解查询和 5 次实时求解,无需信用卡。付费套餐从每月 $3 的 Starter 起。
适用场景
在公布的 Free 月度额度内试用已文档化的 API 工作流。
不适用于
假设 Free 额度可覆盖超出这些公开计数器的生产用量。
可验证来源
定价

有多快?

preflop 与 flop 毫秒级返回。turn/river 按需求解:提交到 /v1/gto/solver,轮询 /v1/gto/solver/tree 到 queryable 再读——available → computing → queryable 状态机。

有 OpenAPI 与交互式参考吗?

直接回答
有。公开 OpenAPI 快照位于 /openapi.zh.json,并提供交互式参考和 LLM 上下文。
适用场景
查看已文档化操作,或从公开 API contract 生成客户端。
不适用于
把未文档化端点或字段视为受支持功能。
可验证来源
公开 OpenAPI

有 SDK 或 MCP server 吗?

直接回答
有。官方客户端包括 Python 的 pokerai-bet、TypeScript 的 @pokerai/client,以及面向 AI agent 的 @pokerai/mcp;也可由公开 OpenAPI contract 生成其他客户端。
适用场景
通过列出的官方客户端包或 OpenAPI 生成的客户端进行集成。
不适用于
假定未列出的包是官方包,或支持未文档化的 API 行为。
可验证来源
API 参考

如何联系支持或销售团队?

请通过联系页面选择正确的官方渠道。产品、账户、配额或账单问题请发送至 support@pokerai.bet;Scale 套餐与合作请发送至 sales@pokerai.bet。

如何报告安全问题?

请发送邮件至 security@pokerai.bet。不要在 Telegram、Discord、GitHub 或其他公开渠道发布漏洞细节、API Key、鉴权 Header 或个人数据。