如何用 API 获取扑克 draws、outs 与 blockers？

向公开 PokerKit 操作提交已结束手牌的牌面与底牌，获取事实性的 draw、out 与 blocker 标签。

更新于 2026 年 7 月 27 日维护者 Pokerai API

直接答案：将 hole 与 board 发送到 POST /v1/pokerkit/draws、POST /v1/pokerkit/outs 或 POST /v1/pokerkit/blockers。它们是独立的公开 OpenAPI contract：读取 result 前先检查当前 schema；标签仅用于训练、复盘、学习或研究，不能用于真实资金牌桌的行动选择。

Quick facts

操作	`POST /v1/pokerkit/draws`、`/outs` 与 `/blockers`
必填输入	公开 `HandRequest` schema 要求 `hole` 与 `board`
可选输入	当前 OpenAPI schema 允许时使用 `hand_type` 与 `dead`
结果边界	仅为事实性标签；不是胜率、结果保证或建议行动
使用边界	仅限已结束手牌的训练、教学、复盘、学习与研究；禁止真实资金 RTA

输入语义

hole 是 Hero 的两张底牌，board 是三、四或五张公共牌。使用无分隔符的标准两字符牌码。共享公开 HandRequest schema 还记录 hand_type 与 dead；不要虚构未支持的牌局格式或字段。

最小公开 OpenAPI 请求与响应

三个操作共享公开 HandRequest contract。此最小请求只使用必填字段；将 /draws 替换为 /outs 或 /blockers 即可获取更窄的事实结果，并应检查当前操作专属的 response schema。

POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json

{"hole":"JhTh","board":"AsKsQs"}

如何解读结果

将 draws 视为已文档化的 draw 标签，将 outs 视为已文档化的改善牌类别与计数，将 blockers 视为已文档化的 nut-combo 阻断证据。计数或标签并不表示概率、对手范围、equity、solver EV 或建议行动。除非当前操作 schema 标记为必需，否则客户端应将字段视为可选。

适用场景

可用于 trainer、教学工具、手牌历史复盘、学习笔记或研究流程，为一手已结束牌局添加标签。若需要组合式事实概览，请使用 Hand Report。

不适用场景

不要将这些标签用于估算胜率、保证结果、选择实时行动，或支持未公开的牌局格式。不要将输出连接到 live-table feed 或自动化。

配额与错误

这些操作使用公开 API key 与账号配额体系。请在配额文档、定价页和 dashboard 查询当前限制，不要硬编码额度。公开 contract 声明了验证错误：请根据当前 API Reference 修正 hole、board 与可选字段；鉴权或配额失败请遵循错误文档，不要重试未改变的无效请求。

SDK、MCP 与相关资源

开发者文档涵盖 SDK、MCP、鉴权与配额。API Reference 与 OpenAPI snapshot 是当前公开 contract。官方入口包括 Python SDK、TypeScript / JavaScript SDK 和 MCP server。

禁止真实资金 RTA

Pokerai API 仅用于训练、教学、手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助。绝不应将 draws、outs 或 blockers 呈现为实时行动指令。

端点	任务	用途
`POST /v1/pokerkit/draws`	读取 draw 标签	返回所提交手牌和牌面的已文档化 draw 结果。
`POST /v1/pokerkit/outs`	读取改善 outs	返回已文档化的 out 类别与计数。
`POST /v1/pokerkit/blockers`	读取 blocker 证据	返回已文档化的 nut-combo blocker 字段。