如何用 API 计算扑克范围 equity？

把每位玩家的范围、可选牌面和可复现的蒙特卡洛控制项发送到 PokerKit equity endpoint；返回的份额用于解释给定局面，而不是预测结果。

更新日期 2026 年 7 月 26 日维护方 Pokerai API

直接答案：使用 ranges（每位玩家一个范围记法数组）调用 POST /v1/pokerkit/equity。可选传入牌面、sample_count 和 seed。响应会为每个输入范围返回一个蒙特卡洛 equity，并返回实际使用的 sample count。

Quick facts

Endpoint	`POST /v1/pokerkit/equity`
输入	两个或更多按玩家区分的 PokerKit 范围记法；`board` 为可选。
方法	蒙特卡洛 equity 估算。它只针对提交的范围和牌面给出估算，不承诺赔率。
响应	`result.equities` 的顺序与 `ranges` 对应；`result.sample_count` 给出抽样语境。
配额	该 endpoint 消耗 1 次 solve 配额；当前 Free tier 每月含 25 次实时求解。
访问	PokerKit 与 GTO endpoints 共用同一 API key；发送一种受支持的 API-key header。

每位玩家使用一个嵌套范围数组。数组顺序很重要，因为返回的 equities 使用相同顺序。若提供牌面，它是无分隔的牌字符串，例如 AhKhQh。

字段	含义
`ranges`	必填。按玩家区分的范围记法字符串数组，例如 `[["AA"], ["KK"]]`。
`board`	可选的已知牌面字符串；未知牌面时省略或使用空字符串。
`sample_count`	可选的蒙特卡洛 sample count。服务端会应用文档中的上限；未设置时使用默认值。
`seed`	用于可复现抽样的可选 seed。

此公开 docs-code 示例在未知牌面下比较 AA 和 KK，并固定 sample count 和 seed。实际发起 HTTP 请求时，请将你的 API key 加入鉴权 header。

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

第一个值 0.8235 对应第一个输入范围（AA）；第二个值 0.1765 对应 KK。在 UI 或报告中必须保留这个顺序。

将 sample_count: 2000 读作本次响应实际使用的蒙特卡洛样本数。它描述的是估算的抽样语境，不是未来发牌、下注或表现的承诺。

适用于训练产品、已结束手牌的复盘、教学工具、研究，或向用户明确展示范围和牌面的解释 UI。将提交的输入和结果一同保存，使估算可追溯。

不要把 equity 估算作为真钱牌局中的实时行动提示；它不能替代玩家判断、完整游戏模型或 solver 策略。不要暗示一次估算能保证获胜、下一张牌或下注结果。

请求携带 Authorization: Bearer $POKERAI_API_KEY（或等价的 X-API-Key）。该 endpoint 消耗 1 次 solve 配额；当前 Free tier 每月有 25 次实时求解。请在控制台查看当前用量，并在设计批处理前阅读配额主题页。

HTTP	含义	处理方式
401	`missing_api_key` 或 `invalid_api_key`。	发送一种有效的 API-key header，并且不要将 Key 写进客户端日志。
配额	适用的月度配额耗尽时返回 `quota_exceeded`。	等待月度重置或调整工作量；不要对未变的请求重试。
422	请求校验失败，例如 body 形状无效。	查看当前 Reference 或 OpenAPI schema，并修正输入。

Pokerai API 用于训练、教学、手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助。不要将 equity 展示接入实时牌局自动化，也不要把它变成行动推荐。