如何用 API 分析扑克牌面？

将翻牌、转牌或河牌牌面发送给公开 PokerKit 的仅牌面 operation，并按训练或复盘流程需要选择响应形状。

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

直接答案：只传 board 给 POST /v1/pokerkit/board-report，一次获取 texture 与 nuts；需要按成手类别查看 live 两张牌 combo 时用 POST /v1/pokerkit/category-combos，需要牌面标签时用 POST /v1/pokerkit/texture，需要最强可成牌与并列 combo 时用 POST /v1/pokerkit/nuts。这些仅牌面结果不是 equity 或策略。

核心事实

必填输入	`board`：3、4 或 5 张无分隔符公共牌字符串，例如 `AsKsQs`
Board Report	`POST /v1/pokerkit/board-report` 返回 `texture` 与 `nuts`
Category Combos	`POST /v1/pokerkit/category-combos` 在 `by_category` 中按成手类别分组 live 两张牌 combo
用途边界	仅限训练、教学、已结束手牌复盘、学习和研究；禁止真实资金 RTA

选择牌面 operation

需求	公开 operation	结果
一次获取牌面概览	`POST /v1/pokerkit/board-report`	`texture` 与 `nuts`。
live 成手 combo	`POST /v1/pokerkit/category-combos`	`by_category` 按成手类别分组 live 两张牌 combo。
牌面标签	`POST /v1/pokerkit/texture`	wetness、connectivity、rank band、听牌标签与花色形态布尔值。
最强可成牌	`POST /v1/pokerkit/nuts`	最强可成手牌、并列 combo 与已文档化标记。

四个 operation 都只分析牌面：将标准两字符牌码直接拼接，例如 AsKsQs。不要传 hole cards。可选 hand_type 与 dead 仅以当前公开 OpenAPI schema 的定义为准。

可验证的 Board Report 请求与响应

此公开 pokerkitBoardReport 示例调用 POST /v1/pokerkit/board-report。

{"board":"AsKsQs"}

{"result":{"texture":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"are_monotone":true},"nuts":{"hand":"TsJsKsQsAs","combos":[{"cards":["Ts","Js"]}],"candidate_count":1176,"board_is_nuts":false,"is_royal":true,"label":{"name":"STRAIGHT_FLUSH","value":"Straight flush"}}}}

此响应说明牌面为 monotone，并给出最强可成牌及其并列 combo；它不说明该手牌获胜的概率、范围应如何行动，或该采取什么行动。

Category Combos、Texture 与 Nuts 回答不同问题

复盘 UI 需要按成手类别展示 live 两张牌组合时，用 Category Combos；其公开示例在 by_category 中返回如 HIGH_CARD 的条目。只需要牌面描述时用 Texture。需要最强可成牌、并列 combo、candidate_count、board_is_nuts、is_royal 和标签时用 Nuts。需要 texture 和 nuts 两者时，Board Report 是紧凑选择。

它不回答什么

牌面分析不计算 equity、不估计 hand strength、不比较 ranges、不产生 solver result，也不推荐行动。提交玩家底牌的分析请见扑克手牌分析 API 指南；聚焦牌面标签请见PokerKit texture API 指南。

错误、集成与 no-RTA

已文档化的 422 表示应按当前API Reference或OpenAPI snapshot检查 board 和可选字段；不要重试未改变的无效请求。官方 SDK 和 MCP 设置请见开发者文档，账号配额处理请见配额。Pokerai API 仅用于训练、教学、已结束手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助；不要将牌面分析接入 live-table automation 或展示为行动指令。llms.txt列出了公开入口。

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