如何发出第一次 GTO 扑克 API 请求?

核心事实

什么时候使用本快速开始

适合用来验证鉴权、查看响应结构,或开始构建陪练、学习工具、手牌复盘流程、后端服务与 AI agent 集成。

什么时候不应使用

不要把该端点用于真实资金牌局中的实时建议。若要处理自定义翻牌、转牌或河牌树,请按开发者文档里的实时求解流程操作,不要把翻前查询当成通用后续街 solver。

最小 curl 请求

创建 key,在本地保存为 POKERAI_API_KEY,然后运行下面的请求。不要把真实 key 提交到仓库,也不要放进客户端代码。

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hole_cards": "9h9s",
    "positions": { "hero": "MP" },
    "preflop_actions": [
      { "position": "SB", "action": "small blind", "amount": 0.5 },
      { "position": "BB", "action": "big blind", "amount": 1 },
      { "position": "UTG", "action": "raise", "amount": 2.5 }
    ]
  }'

真实响应

这份已捕获响应对应 MP 持有 9h9s、面对 UTG 2.5bb 开池的局面:

{
  "hole_cards": "9h9s",
  "situation": "Raise",
  "strategy": [
    { "action": "fold", "frequency": 0.254 },
    { "action": "call", "frequency": 0.106 },
    { "action": "raise", "frequency": 0.64, "amount_bb": 9, "sizing_pot": 1 }
  ]
}

三个频率之和为 1:fold 25.4%、call 10.6%、raise 到 9bb 64%。应把它作为学习或采样用的策略分布,而不是某个行动必然盈利的承诺。

配额

Pokerai API 分开计量预求解查询和实时求解。本次翻前请求消耗 1 次预求解查询。Free 每月包含 1,000 次预求解查询和 25 次实时求解;两个计数器每月重置,当前用量可在控制台查看。公开额度以定价页为准。

常见错误

该端点的公开 OpenAPI 契约声明了以下非成功响应:

SDK 与 MCP 选项

官方客户端遵循同一份公开 OpenAPI 契约,并使用同一个 API key 与配额。完整类型化示例见 SDK 文档。

• Python SDK:pip install pokerai-bet(导入名为 pokerai)。
• TypeScript / JavaScript SDK:npm install @pokerai/client。
• 供 AI agent 使用的 MCP server:npx @pokerai/mcp。默认启用预求解工具;启用 solver 工具会消耗独立的 solve 配额。

禁止真实资金 RTA