1. 首页
  2. 文档
  3. 如何使用 Pokerai API 计算扑克 equity？
文档主题 · PokerKit equity

如何使用 Pokerai API 计算扑克 equity？

将两个或更多玩家范围发送给公开的 PokerKit equity 端点；仅在需要时添加牌面、样本数和随机种子。

更新于 维护者 Pokerai API

直接答案：调用 POST /v1/pokerkit/equity 并提供必填的 ranges 数组。这是 Monte-Carlo equity 计算，不是 GTO 推荐，也不是实时牌局辅助。

Quick facts

事项说明
操作POST /v1/pokerkit/equity
必填参数ranges：按玩家划分的范围记法数组。
可选参数board（默认空字符串）、sample_count 与 seed。
方法Monte-Carlo；OpenAPI 说明 sample_count 有上限，未设置时使用默认值。
可复现性seed 是公开请求参数，用于可复现抽样。

最小 API 请求

curl -s https://pokerai.bet/v1/pokerkit/equity \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ranges":[["AA","KK"],["QQ","JJ"]]}'

公开 EquityRequest schema 只要求 ranges。已知牌面时再添加 board；只有需要文档化的抽样控制时才添加 sample_count 或 seed。

如何解读响应

成功响应在公开契约中标为 HTTP 200。公开 OpenAPI snapshot 有意不限定响应 schema，因此客户端应检查返回的 JSON，不应假定未文档化字段或单一推荐动作。equity 描述的是提交的范围和牌面，不提供 GTO 策略。

错误、限制与安全使用

HTTP公开契约处理方式
422HTTPValidationError检查必填 ranges 的结构及所有已提供参数的类型。
抽样sample_count 有上限不要假定提交的更大值会被采用；以 API 响应和 Reference 的当前行为为准。

此端点仅用于训练、教练、复盘、学习和研究。真钱牌桌的实时辅助（RTA）被禁止。本页不发布套餐专属额度，也不承诺牌桌实时辅助。

相关文档

禁止在真实资金牌桌上提供实时辅助。