用 PokerAI Cache API 打造低延迟实时扑克分析产品
用 PokerAI Cache API 读取已保存的三街策略,在查询完成后立即显示动作频率。本文用一手真实的 200NL 3-bet 演示完整接入过程,包括筛选场景、切换动作和牌面,以及按需查询 EV 和 EQ。
/cache/query 读取当前节点的策略。响应返回后即可显示各动作的频率。展开动作收益或权益时,再分别调用 /cache/ev 或 /cache/eq,让策略页在指标返回前就能使用。什么时候用 Cache API?
这篇 Guide 适合想直接展示三街策略的产品。对于已经完整预解的场景,Flop、Turn 和 River 在同一棵翻后博弈树里一次联合求解。API 沿牌面和行动读取同一份解,保留三街之间的均衡一致性。这里的纳什均衡近似以原来的范围、筹码、下注树和求解精度为边界。
策略查询及独立 EV/EQ 需要 Builder 或 Pro。任何有效 API key 都可以免费查 coverage。当前只有部分场景已有缓存;目录列出可用的场景根节点,具体行动和发牌能否继续读取,以查询响应为准。
200NL 3-bet 牌局的核心事实
本例使用翻前策略包 6max_RC_100bb_200NL。MP(中间位)开池,SB(小盲)3-bet。SB 持 A♥K♥,Flop 为 4♣8♦9♥。进入翻牌时,底池为 19 BB,剩余有效筹码为 91 BB。
| 街与牌面 | 动作 | 下一步 |
|---|---|---|
| Flop4♣ 8♦ 9♥ | SB 下注 13 BB MP 跟注 | 发 A♠ |
| TurnA♠ | SB 下注 14 BB MP 跟注 | 发 7♦ |
| River7♦ | SB 下注 22 BB MP 跟注 | 摊牌 |
沿图中的路径查询,SB 在三条街分别下注 13、14、22 BB,MP 每次跟注。River 上 A♥K♥ 更常过牌,本例继续读取 22 BB 下注后的分支,直到摊牌。
查找已覆盖的场景
向 /cache/coverage 传入翻前策略包和翻牌,列出已经有持久缓存的场景。任何有效 API key 均可免费查询,presolved、solve 和 cache 额度都不会变化。
curl -G 'https://pokerai.bet/v1/gto/postflop/cache/coverage' \
-H "Authorization: Bearer $POKERAI_API_KEY" \
--data-urlencode 'preflop_pack=6max_RC_100bb_200NL' \
--data-urlencode 'board=4c8d9h' \
--data-urlencode 'limit=200'
preflop_pack 和 board 均为必填。这个请求的实际响应中包含以下场景。目录响应节选
{
"preflop_pack": "6max_RC_100bb_200NL",
"board": "4c8d9h",
"pot_type": "3BET",
"positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}
选中“MP 开池 · SB 3-bet”这一项后,可直接用返回的 preflop_pack、board、pot_type 和 positions 打开策略根节点。若翻完目录仍找不到目标场景,可以显示“该场景暂无缓存策略”,等用户选择实时求解后再调用求解端点。
翻页时保持 preflop_pack 和 board 不变,把 next_cursor 原样传给下一次请求的 cursor。即使本页 items 为空,只要有游标就继续。读到 next_cursor: null 时结束。
读取 Flop 策略
用 /cache/query 打开 Flop 根节点,并传入 hole_cards: "AhKh",读取 A♥K♥ 的策略。由你的后端发起请求并保管 API key。
- 1. 查找可用场景
/cache/coverage免费查询目录 - 2. 读取并展示策略
/cache/query新根和每次发牌各扣 1 次,普通动作续查免费 - 3. 按需查询指标
/cache/ev或/cache/eq通过准入的独立请求各扣 1 次
下方请求读取新根节点并消耗 1 次 Cache 查询额度。
POST /v1/gto/postflop/cache/query
{
"preflop_pack": "6max_RC_100bb_200NL",
"board": "4c8d9h",
"pot_type": "3BET",
"positions": {"hero": "SB", "raiser": "MP", "three_bettor": "SB"},
"hole_cards": "AhKh"
}
把响应中的 strategy 渲染成动作频率,并保存 token 供后续查询。响应里的 node: "root" 可作为路径标签。续查时,请求体的 node 接收对应的 token。
如果你已读取整个范围的策略矩阵,切换手牌时可以直接取对应行。切换到新的动作节点或牌面时,再发起一次读取。
沿动作查询 Turn 和 River
Flop 上,A♥K♥ 下注 13 BB 的频率约为 69.02%。对手跟注后,Turn 发出 A♠,下注 14 BB 的频率约为 77.65%。再次跟注,River 发出 7♦,策略以过牌为主(88.63%)。接下来沿约占 10.20% 的 22 BB 下注分支查询,直到 MP 跟注后的摊牌节点。
- 过牌 23.53%
- 下注 6 BB 7.45%
- 下注 13 BB 69.02%
- 全下 0.00%
- 过牌 1.96%
- 下注 14 BB 77.65%
- 下注 31 BB 20.39%
- 全下 0.00%
- 过牌 88.63%
- 下注 22 BB 10.20%
- 全下 1.18%
查询下注或跟注时,把对应子节点的 token 传给 node。到达发牌节点(chance)以后,再传入该节点的 token 和 turn_card 或 river_card。示例中的 query 封装了 /cache/query。含鉴权和错误处理的完整代码
// cachedAction 返回指定 cached=true 动作的 token。
const opponent = await query("flop-bet", {
node: cachedAction(flop, "bet", 13),
});
const chance = await query("flop-call", {
node: cachedAction(opponent, "call"),
});
const turn = await query("turn-deal", {
node: chance.token,
turn_card: "As",
hole_cards: "AhKh",
});
// Turn 走 14 BB 下注及跟注,再从 chance 发出 River 7♦。
上例的两次动作续查免费。每次提交一张新的 Turn 或 River 都扣 1 次 Cache 查询额度。发牌后保留此前的动作路径,便于回到你刚才查看的节点。
按需查询 EV 和 EQ
用 /cache/ev 查询动作收益,用 /cache/eq 查询手牌权益。两个端点都接收当前行动节点(action)的 token 和具体手牌。策略包、牌面与范围由 token 确定。
// http 接收日志标签、路径和 JSON 请求体。
const hand = { node: flop.token, hole_cards: "AhKh" };
// 展开动作收益时查询 EV。
const ev = await http("flop-ev", "/v1/gto/postflop/cache/ev", hand);
const actionValues = ev.ev.status === "ok" ? ev.ev.action_values : null;
// 展开手牌权益时独立查询 EQ。
const eq = await http("flop-eq", "/v1/gto/postflop/cache/eq", hand);
const equityPercent = eq.eq.status === "ok" ? eq.eq.value * 100 : null;
/cache/query 只读取策略。旧参数 include_ev:true 或 include_eq:true 会返回 HTTP 400,不会扣额或启动计算。普通策略查询可以省略这两个字段,旧客户端也可保留 false。
表中 Flop 指标来自同一手牌的根节点实测,Turn 和 River 指标来自图 1 的下注线路。EV 是按缓存策略计算的净收益,单位为 BB。EQ 使用当前公牌及缓存 Flop 根节点的对手范围,该范围在后续动作中保持固定。
| 节点及此前路径 | A♥K♥ 组合 EV | EQ |
|---|---|---|
| Flop 4♣8♦9♥(此前捕获) | −6.4512 BB | 44.5677% |
| Turn A♠(Flop 13 BB、跟注) | 18.8904 BB | 83.2143% |
| River 7♦(再下 14 BB、跟注) | 5.3115 BB | 73.4660%(本轮复验) |
要比较不同动作的收益,请读取同一节点的 action_values。表中的组合 EV 随牌面和动作路径变化。EQ 提供手牌权益,动作 EV 请直接读取 API 返回值。查看实测指标响应
请求耗时与额度
同一轮 Flop 实测中,策略响应在 4.425 秒返回,独立 EV 和 EQ 分别用时 14.184 秒和 8.566 秒。River 复验中,发牌后 1.319 秒拿到策略,独立 EQ 用时 6.827 秒。先渲染策略响应,展开 EV 或 EQ 时再发单独的请求,就能把这两段等待分开。
| 请求 | 耗时 | 轮次 | |
|---|---|---|---|
| Flop4♣ 8♦ 9♥ | |||
| 策略 · 根 | 4.425 秒 | A | |
| EV | 14.184 秒 | A | |
| EQ | 8.566 秒 | A | |
| TurnA♠ | |||
| 策略 · 发牌 | 1.348 秒 | B | |
| EV | 6.983 秒 | B | |
| EQ | 6.482 秒 | B | |
| River7♦ | |||
| 策略 · 发牌 | 1.319 秒 | C | |
| EV | 6.519 秒 | B | |
| EQ | 6.827 秒 | C | |
每根柱代表一次成功请求。耗时会随节点和运行状态变化。
读取新根节点、发新牌或独立查指标会消耗 Cache 查询额度。普通动作续查免费。
| API 操作 | 扣减 Cache 查询额度 |
|---|---|
通过 /cache/coverage 查询目录 |
0 |
通过 /cache/query 读取新根节点 |
1 次 |
| 用有效 token 续查普通动作节点 | 0 |
通过 /cache/query 发一张新的 Turn 或 River |
1 次/请求 |
| 通过准入的独立 EV 或 EQ 查询 | 1 次/请求 |
沿本例查完三街策略共扣 3 次。 如果在每街再各查一次 EV 和 EQ,总计扣 9 次。本轮复验只在 River 查 EQ,总计扣 4 次,其中 Turn 跟注续查用时 1.317 秒,扣额为 0。
无效输入、失效 token 和其他准入前拒绝都不扣额度。错误也可能发生在扣额之后。遇到错误时先核对 cache_quota,避免自动重试。再次提交会作为一条新的独立请求处理。
运行完整接入示例
接入页面时,保留位置、手牌、公牌和动作路径。策略加载完成后即可显示。EV、EQ 各自处理加载和错误状态,指标暂不可用时保留已经取得的策略。
下载三街 Node.js 示例。脚本会查询目录、读取 Flop 策略、沿三次下注和跟注走到摊牌,再读取每街的 EV 与 EQ。目录一页且全程成功时,共发出 16 个请求,扣 9 次。
使用 Builder/Pro API key 在线运行会消耗你账号的额度。脚本遇到错误会停止,已取得的指标仍保留在输出中。
export POKERAI_API_KEY='你的服务端 API key'
node reproduce.mjs
实测数据与复现记录
本文数据来自 2026 年 11 月 18 日的公开 HTTPS 请求。原三街采集保留了 13 个成功响应和一次 River EQ 503。River EQ 复验沿相同路线使用新 token,8 个请求全部成功。Flop 根、两次发牌和 River EQ 各扣 1 次。
引用时请附上策略包、牌面、动作路径、日期和计时口径。这些耗时是本场景的单次请求样本。
本文面向训练、研究和赛后复盘。这里的“实时分析”指用户在工具中连续探索场景的交互体验,不用于进行中的真人牌局辅助。禁止在真实资金牌桌上提供实时辅助。
API 文档 · API 参考 · OpenAPI · llms.txt
没有缓存时,继续用实时 Solver
如果查不到这一手的缓存、还在用 Free 或 Starter,或者想改后两街的范围和尺寸,可以先展示 Flop 预解策略,再逐街求解。
用 PokerAI 预解数据与实时 Solver 打造低延迟扑克分析产品。配套 Guide 沿用同一个 200NL 3-bet 牌局,演示如何转换双方范围,以及何时向用户展示 Turn 和 River 的策略。