← 全部指南
本页内容
指南 GTO 策略 · 01/08 求解器应用 10 分钟 中级

用 PokerAI Cache API 打造低延迟实时扑克分析产品

用 PokerAI Cache API 读取已保存的三街策略,在查询完成后立即显示动作频率。本文用一手真实的 200NL 3-bet 演示完整接入过程,包括筛选场景、切换动作和牌面,以及按需查询 EV 和 EQ。

更新于 维护者 Pokerai API

打开一手牌时,先用 /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 跟注
摊牌
图 1:每街下注后跟注,最后走到摊牌。

沿图中的路径查询,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。

Cache API 接入顺序
  1. 1. 查找可用场景/cache/coverage免费查询目录
  2. 2. 读取并展示策略/cache/query新根和每次发牌各扣 1 次,普通动作续查免费
  3. 3. 按需查询指标/cache/ev 或 /cache/eq通过准入的独立请求各扣 1 次
图 2:先查可用场景,再读取策略。EV 和 EQ 可在展开对应指标时分别查询。

下方请求读取新根节点并消耗 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 跟注后的摊牌节点。

A♥K♥ 的三街策略频率
Flop 4♣ 8♦ 9♥
  • 过牌 23.53%
  • 下注 6 BB 7.45%
  • 下注 13 BB 69.02%
  • 全下 0.00%
Turn A♠
  • 过牌 1.96%
  • 下注 14 BB 77.65%
  • 下注 31 BB 20.39%
  • 全下 0.00%
River 7♦
  • 过牌 88.63%
  • 下注 22 BB 10.20%
  • 全下 1.18%
图 3:每街策略均对应前文的动作路径。图中百分比经过归一化和四舍五入,原始频率见请求记录。

查询下注或跟注时,把对应子节点的 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 时再发单独的请求,就能把这两段等待分开。

三街请求耗时 原 200NL 下注线路 · 统一刻度(秒)
请求耗时轮次
Flop4♣ 8♦ 9♥
策略 · 根4.425 秒A
EV14.184 秒A
EQ8.566 秒A
TurnA♠
策略 · 发牌1.348 秒B
EV6.983 秒B
EQ6.482 秒B
River7♦
策略 · 发牌1.319 秒C
EV6.519 秒B
EQ6.827 秒C
同字母为同一轮 · 11 月 18 日香港时间 A Flop 根节点实测,13:37–13:38 B 三街下注采集,17:44–17:45 C River EQ 复验,20:52
图 4:从发出公开 HTTPS 请求到读完响应。River 的 EV 与 EQ 来自不同轮。查看每项实测来源。

每根柱代表一次成功请求。耗时会随节点和运行状态变化。

读取新根节点、发新牌或独立查指标会消耗 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

如果查不到这一手的缓存、还在用 Free 或 Starter,或者想改后两街的范围和尺寸,可以先展示 Flop 预解策略,再逐街求解。

用 PokerAI 预解数据与实时 Solver 打造低延迟扑克分析产品。配套 Guide 沿用同一个 200NL 3-bet 牌局,演示如何转换双方范围,以及何时向用户展示 Turn 和 River 的策略。