如何用 PokerKit API 分析牌面 texture？
将翻牌、转牌或河牌牌面发送到 POST /v1/pokerkit/texture，即可获得该牌面的已文档化分类 texture 与花色形态字段。
board，例如 AsKsQs，并调用 POST /v1/pokerkit/texture。将返回的 result 读作牌面描述字段，而不是 equity、GTO 策略或实时行动建议。核心事实
| 端点 | POST /v1/pokerkit/texture |
|---|---|
| 必填输入 | board：3、4 或 5 张无分隔符公共牌字符串，例如 AsKsQs |
| 可选输入 | 公开 OpenAPI schema 定义的 hand_type 和 dead |
| 响应 | 含 cards、分类 texture 字段与花色形态布尔值的 result 对象 |
| 用途边界 | 仅限训练、教学、手牌复盘、学习和研究；禁止真实资金 RTA |
输入语义
board 为必填字段。将标准两字符牌码直接拼接：3 张表示翻牌、4 张表示转牌、5 张表示河牌。公开 schema 还允许可选的 hand_type 与 dead；除非已文档化的工作流需要，否则不要传入。该端点描述牌面而非玩家手牌，因此不要提交 hole cards。
最小请求
使用 JSON 和 API key。下方请求体与响应来自公开 pokerkitTexture docs-code 示例。
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'响应解读
{"result":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"connectivity":{"name":"HIGH","value":"High"},"rank_band":{"name":"HIGH","value":"High"},"straight_draw":{"name":"OPEN_ENDED","value":"Open-ended"},"flush_draw":{"name":"LIVE","value":"Live"},"are_two_tone":false,"are_monotone":true,"are_rainbow":false}}cards 将输入牌面规范化为数组。wetness、connectivity、rank_band、straight_draw 与 flush_draw 是带 name 和展示用 value 的分类描述符。三个布尔值描述返回牌面的花色形态：本例中 are_monotone 为 true，而 are_two_tone 和 are_rainbow 为 false。这些标签描述的是本次输入，不计算 equity，也不会选择扑克行动。
适用场景
当训练、教学或已结束手牌复盘流程需要在展示其他已文档化分析前，先得到一致的牌面描述时，使用 Texture。若需要合并的牌面概览，请查看独立公开的 POST /v1/pokerkit/board-report contract；若需要玩家特定分析，请查看公开的 hand-report、draws、outs 或 blockers contract。
不适用场景
不要将 texture 标签视为 equity estimate、solver result、手牌强度保证或推荐行动。Texture 不能代替已文档化的 equity、GTO 或玩家手牌 endpoint 请求，也不得用于真实资金牌局的实时决策辅助。
配额和错误
该端点与公开 PokerKit API 使用相同的 API key 和账号配额体系。请在配额文档、定价页和 dashboard 中查看当前账号限制与用量，不要在客户端硬编码额度。
| 信号 | 含义 | 处理方式 |
|---|---|---|
| 422 | 公开 OpenAPI contract 声明了验证错误响应。 | 按当前 Reference 或 OpenAPI schema 检查 board 与可选字段，然后修正请求。 |
| 其他 API 错误 | 鉴权和账号配额处理在 API 层文档中说明。 | 使用当前错误文档与 dashboard 状态；不要重试未改变的无效请求。 |
SDK、MCP 与相关资源
- 开发者文档 — 官方 SDK 和 MCP 设置，以及鉴权和配额。
- API Reference — 查看当前 Texture 请求与响应 contract。
- OpenAPI snapshot — 机器可读的中文 contract。
- Python SDK、TypeScript / JavaScript SDK 和 MCP server — 官方 package 入口。
- 扑克手牌复盘 API 指南 — 将牌面语义放入牌局结束后的工作流。
- llms.txt — 精简的 LLM 入口。