新端点、参数与修复。RSS 仍是单英文 feed,中文变更见本页。 · RSS (EN)
最后更新 · 维护方 Pokerai API · 来源 OpenAPI 快照
Cache 指标端点 — 已于 2026-11-18 在生产上线. Cache EV/EQ 端点已于 2026-11-18 在生产上线。POST /v1/gto/postflop/cache/ev 和 /eq 只接受返回的 action token 与具体 hole_cards。在 /query 中,include_ev:true 或 include_eq:true 现在会在 Auth 校验、计次或 Native 调度之前返回 400 invalid_request;省略/false 仍为普通 query 行为。每个通过准入的独立 EV/EQ 请求都消耗现有 cache 配额 1 次(包括 hit/join),成功响应携带该调用者自己的 cache_quota。准入前不适用/不支持的 missing 消耗 0;确认后失败、超时或取消仍可能已扣。503 cache_charge_unknown 不带配额且不会自动重试;耗尽返回 402 cache_quota_exceeded。保留的 local-isolated capture 明确为 deployed:false,不是生产三街成功或真实扣费捕获。
OpenAPI: POST /v1/gto/postflop/cache/ev · OpenAPI: POST /v1/gto/postflop/cache/eq · API 参考 · 文档缓存 EV/EQ 新端点已完成源码验证,尚未部署。当前生产仍使用历史 include_ev/include_eq query flags。未来 Relay 发布会在鉴权、扣额或 Native 派发之前以 400 invalid_request 拒绝 true;省略/false 仍是普通 query。请只用返回的 action token 和具体 hole_cards 调用 POST /v1/gto/postflop/cache/ev 或 /eq。每个通过准入的独立 EV/EQ 请求均扣 1 个现有缓存额度,包括命中/并发加入;每个通过准入的成功响应均带该调用者本人的 cache_quota。准入前不适用/不支持的 missing 扣 0;503 cache_charge_unknown 不带额度且不自动重试。EV 是 raw_net_bb;EQ 是 root_range_joint,不是后验。已验证的16请求、单 UID、200NL 3BET 回放是 local-isolated/Auth-stub 证据,不是生产或客户扣额。
可选翻后缓存 EQ 已上线. 可选缓存 EQ 已于 2026-11-17 上线。 先展示策略,再用返回的 action token 和具体 hole_cards 请求 include_eq=true;不可与 EV 同时开启。权益比例针对缓存生效的 Flop 根对手范围,不是按后续动作更新的后验范围。node EQ 读取免费;根请求及每次 Turn/River 发牌仍按原规则计费。原有完整三街示例仍为 local-isolated 隔离捕获,不是生产捕获。
已公开 Builder 真实生产成功请求、响应和耗时;这是既有上线功能的文档补充,不是新 SDK 或 API 发布。 生产示例: Docs · JSON · Python · JavaScript
翻后缓存 EV/EQ 预算为 15 秒。Native 单次 EV/EQ 计算硬上限为 15 秒,软预算为 14900ms。Service 读取仍≤15 秒、Relay 总请求仍≤20 秒。实际工作还会因剩余 deadline 与清理预留而提前结束;这些是实现预算,不是通用 SLA。Linux 每进程仍限 2 GiB。原 root/发牌扣额、免费指标 node 读取、固定 token TTL、互斥 flags 及 EV/EQ 数学语义均不变。
OpenAPI: POST /v1/gto/postflop/cache/ev · OpenAPI: POST /v1/gto/postflop/cache/eq · OpenAPI: POST /v1/gto/postflop/cache/query · API 参考 · 文档可选翻后缓存 EV 已上线. 可选缓存 EV 已于 2026-11-16 上线。先查询并展示策略,再用返回的 action token 和具体 hole_cards 请求 include_ev=true;EV 请求会在预算内等待计算。根及发牌沿原规则计费,token 续查不消耗缓存额度。示例仍为 local-isolated,不是生产捕获。
OpenAPI: POST /v1/gto/postflop/cache/query · API 参考 · 文档持久翻后缓存 query 已上线. 已于 2026-11-12 上线。POST /v1/gto/postflop/cache/query 查询预设或完整自定义配置的持久缓存,使用返回的 token 沿动作导航,并以 turn_card / river_card 跨街选牌。仅有效 API Builder/Pro 订阅可用,采用独立订阅服务周期额度:根查询、每次 Turn 和每次 River 选牌各扣 1;有效 token 的普通读取免费。缓存覆盖可能不完整。
免费 preset 缓存 coverage 已上线. 已于 2026-11-13 上线:GET /v1/gto/postflop/cache/coverage 用于发现已发布的 preset 根。任意有效 API key(含 Starter 和额度已尽账号)均可免费浏览,不扣 presolved、solve 或 cache 额度。策略 query 仍需 API Builder/Pro,按原规则计费。本次不代表 SDK 或 MCP 包已发布。 每页必填 board 和 pack 选择:preflop_pack,或原输入别名 flop_version。保持原 board 拼写及 pack 筛选;空 items 页仍继续,直到 next_cursor=null。limit 默认 50,范围 1–200。opaque cursor 不是策略 token;as_of 是本页观察时间,不是跨页快照。目录不保证所有列出的缓存都可读。
preflop_pack 字段迁移已上线. 公开标准输入为 preflop_pack;显式新字段错误不回退旧字段或默认值。 字段迁移已于 2026-11-13 上线。 可选的 preflop chart pack;两个 selector 都省略时使用平台默认 6max。 显式提供 preflop_pack 时,必须为目录内合法非空 string,不 trim 或转换大小写。可同时提供生效的旧别名,但值必须一致;冲突在 consume 前返回 400。纯旧请求保留原省略、null/空值、coercion、错误、默认和 fallback 行为;不得据此放宽严格的 cache 或 coverage 输入。 preflop_pack=A 使 chart 和启用的 guarantee 都选 A。纯旧 preflop_version=A 与 flop_version=B 仍独立,分别默认 6max:只传旧 preflop_version=A 并开启 flag 得到 A/6max,传新 preflop_pack=A 得到 A/A。混用仅比较生效的同义 selector;flag off 时旧 flop_version 即使非法仍忽略。guarantee 输出只发布 preflop_pack,manifest_version 不变。 在 preflop/flop 的 request 内使用 preflop_pack,原 type 对应输入别名仍兼容。requested_preflop_pack 为请求 pack,resolved_preflop_pack 为实际命中 pack(含 fallback)。solver 无 pack selector 或回显。旧输出名不双写;旧输入兼容不保证旧输出读取客户端兼容。 仅输入别名:preflop/preflop-range 兼容已弃用 preflop_version;Flop tree/projected-range、cache preset 兼容已弃用 flop_version;availability 在 request 内按 type 使用对应旧别名。仅原入口接受,solver、custom cache root、node 和 App 专用 /v1/apps/solver/ranges 不增加 pack override。纯旧 server selector 保留 null/空值省略和 coercion,严格 cache/coverage 解析仍严格。canonical preflop_pack 错误为 400 invalid_request;旧 unsupported_preflop_version/unsupported_flop_version 错误不变。pack 目录仍返回 versions/id/default;原无 pack 回显的 API 不新增回显。 规范输出只使用 preflop_pack;availability 使用 requested_preflop_pack 和 resolved_preflop_pack。旧输入兼容不保证旧输出读取客户端兼容。URL 不变。
可选 EV 源码已验收但尚未部署。先按旧方式查询并展示策略,再使用返回的 action token 和 hole_cards 请求 include_ev=true;该请求会在预算内等待计算。使用响应 token,勿用可读 node 路径。EV 是量化缓存固定策略的 raw_net_bb,单位 bb,并非现场 solver EV 或 EQ 乘底池。首版支持可证明的非 ARP preset;custom 和不支持的配置返回 missing。动作值按策略原序,0 和负数有效,missing 不补零,任一动作缺失则 combo 缺失。状态为 ok、partial 或 missing;非 Hero action 保留旧视图,action_values 为空且 missing/not_applicable。每 owner 一个槽,忙时不排队,返回 200 策略及 missing;基础 reader 忙为 429、整次超时为 504、身份漂移为 409。10 秒和 2 GiB 是实现预算,不是通用 SLA。省略或 false 保持旧 wire、计费及固定 token TTL。
OpenAPI: POST /v1/gto/postflop/cache/query · OpenAPI: GET /v1/gto/postflop/cache/coverage · OpenAPI: POST /v1/gto/preflop · OpenAPI: POST /v1/gto/preflop/range · OpenAPI: POST /v1/gto/flop/tree · OpenAPI: POST /v1/gto/flop/projected-range · OpenAPI: POST /v1/gto/availability · API 参考 · 文档POST /v1/gto/postflop/cache/query 查询预设或完整自定义配置的持久缓存,使用返回的 token 沿动作导航,并以 turn_card / river_card 跨街选牌。仅有效 API Builder/Pro 订阅可用,采用独立订阅服务周期额度:根查询、每次 Turn 和每次 River 选牌各扣 1;有效 token 的普通读取免费。缓存覆盖可能不完整。线上可用取决于实际部署。 随后已于 2026-11-12 上线。 OpenAPI: POST /v1/gto/postflop/cache/query · API 参考 · 文档POST /v1/gto/availability:需 API Key 的免费预检,可查询匹配的 preflop、flop 或 solver 请求。它仅返回即时 availability 快照且不扣配额;不预留容量,也不保证后续缓存加载或结果请求成功,后续请求仍按既有计费规则处理。 OpenAPI: POST /v1/gto/availability · API 参考 · 文档POST /v1/gto/flop/tree 现返回 ranges.requested、ranges.effective、ranges.adjusted、adjustment_summary、range_provenance 与可选的 hero_hand_coverage。顶层 range 是策略树实际使用的 effective alias;requested range 仅供审计。removed 手牌不得继续调用 /flop/node,该请求返回 typed HTTP 422 hand_not_in_effective_range。POST /v1/gto/preflop/range 可返回可选的离线 immutable pruning guarantee;缺失或 incomplete coverage 时 fail closed。 OpenAPI: POST /v1/gto/flop/tree · OpenAPI: POST /v1/gto/preflop/range · API 参考 · 文档/v1/gto/solver 除 bet_sizes 外,现支持独立的 raise_sizes、donk_sizes 与 raise_limit 字段。 OpenAPI: POST /v1/gto/solver · API 参考 · 文档POST /v1/gto/solver/release——提前释放某次求解占用的端口,使其立即回池而不必等缓存 TTL(可选、免费;在该 solve 最后一次 /tree//node 查询后调用)。 OpenAPI: POST /v1/gto/solver/release · API 参考 · 文档POST /v1/gto/evs——已完成解在某节点的逐手、逐动作 EV(免费)。 OpenAPI: POST /v1/gto/evs · API 参考 · 文档/v1/gto/turn/projected-range 现支持 partner_hands(从对手范围阻挡队友的死牌)。 OpenAPI: POST /v1/gto/turn/projected-range · API 参考 · 文档/v1/gto/flop/projected-range 现读取请求里的 bluff_discount_ratio / bluff_combos_ratio、把 Hero 自己底牌注入 Hero 范围,并支持 partner_hands。 OpenAPI: POST /v1/gto/flop/projected-range · API 参考 · 文档/v1/pokerkit/*):牌面/手牌语义、范围权益、评牌/ICM、牌局模拟——复用同一 Key 与配额。 OpenAPI: /v1/pokerkit/* · API 参考 · 文档POST /v1/gto/preflop/range——整段 13×13 翻前范围,一次返回。 OpenAPI: POST /v1/gto/preflop/range · API 参考 · 文档/v1/gto/flop/tree(取树)+ /v1/gto/flop/node(取节点,免费),与求解器的 tree/node 对齐。 OpenAPI: POST /v1/gto/flop/tree · OpenAPI: POST /v1/gto/flop/node · API 参考 · 文档/v1/gto/flop/projected-range + /v1/gto/turn/projected-range、OpenAPI 3.0 规范、实时 flop 求解,以及统一的牌面/手牌格式。 OpenAPI: POST /v1/gto/flop/projected-range · OpenAPI: POST /v1/gto/turn/projected-range · API 参考 · 文档