← 全部指南
本页内容
  1. 首页
  2. 教程
  3. 如何用 Pokerai Python SDK 发出第一个请求？
快速开始 从这里开始 · 03/06 Python 10 分钟 初级

如何用 Pokerai Python SDK 发出第一个请求？

安装 pokerai-bet、导入 pokerai、用 API key 创建 AuthenticatedClient，再调用 SDK 为 POST /v1/gto/preflop 提供的已文档化封装。

更新于 维护者 Pokerai API

直接答案：使用 pip install pokerai-bet，将 POKERAI_API_KEY 保存在环境变量中，再调用 preflop_strategy.sync(client=client, body=req)。类型化结果代表已文档化响应或已文档化 API 错误；它不是实时牌局建议。

核心事实

官方包入口pip install pokerai-bet；导入包名为 pokerai
首个 SDK 调用preflop_strategy.sync 封装 POST /v1/gto/preflop
认证AuthenticatedClient 通过 Bearer token 发送 API key；从控制台登录创建 key
响应带有 situation、strategy 与 quota 的类型化翻前响应，或已文档化错误模型
Free 额度1,000 次预解查询 + 25 次实时求解 / 月；该请求消耗 1 次预解查询
用途边界仅限训练、教学、手牌复盘、学习和研究；禁止真实资金 RTA

安装与认证

安装已批准产品事实中列出的包名，然后在本地导出 API key。不要提交真实 key、不要将其放入浏览器代码，也不要在日志中输出。

python -m pip install pokerai-bet
export POKERAI_API_KEY="gto_your_key_here"

最小 Python SDK 请求

这是公开翻前策略操作的官方 SDK client 模式。请求结构、端点与非成功状态码均由当前OpenAPI snapshot定义。

import os

from pokerai import AuthenticatedClient
from pokerai.api.lookup import preflop_strategy
from pokerai.models import (
    PreflopRequest,
    PreflopRequestPositions,
    PreflopRequestPreflopActionsItem,
    PreflopRequestPreflopActionsItemAction as Act,
)
from pokerai.models.position import Position

client = AuthenticatedClient(
    base_url="https://pokerai.bet",
    token=os.environ["POKERAI_API_KEY"],
)

req = PreflopRequest(
    hole_cards="AhKh",
    positions=PreflopRequestPositions(hero=Position.MP),
    preflop_actions=[
        PreflopRequestPreflopActionsItem(position=Position.SB, action=Act.SMALL_BLIND, amount=0.5),
        PreflopRequestPreflopActionsItem(position=Position.BB, action=Act.BIG_BLIND, amount=1),
        PreflopRequestPreflopActionsItem(position=Position.UTG, action=Act.RAISE, amount=3),
    ],
)

result = preflop_strategy.sync(client=client, body=req)
print(result)

如何解读响应

成功响应中，situation 是推导出的翻前状态，遍历 strategy 即可读取行动。每个策略项都有 action 和 0 到 1 的 frequency；bet 或 raise 项还可能给出 sizing_pot、amount_bb 与 allin。这些频率是用于学习或采样的混合分布，不是盈利承诺或单一推荐行动。

响应还可能包含 quota。请从返回结果或控制台记录账号用量，不要用客户端计数器推断。当前响应结构以公开 contract 为准，不应被硬编码 SDK 假设替代。

错误和配额处理

该操作的公开 contract 声明 400、401 和 429。生成的 SDK 会将已文档化错误响应解析为错误模型；若还需要 HTTP status 和 headers，请使用 sync_detailed。无效输入应先修正而不是原样重试；缺失或无效认证时检查 Bearer key；429 时检查账号额度和当前配额文档。

何时使用

适合在服务端 trainer、教练产品、已结束手牌复盘工具、学习流程、研究项目，或带人工审核的 AI agent 集成中使用这一 SDK 模式。当你需要类型化请求和响应模型、同时仍以公开 API contract 做校验时，这是一个简洁的起点。

何时不应使用

不要将此示例用于会暴露 API key 的浏览器代码、实时牌桌数据源或行动自动化循环。不要推断当前公开源码和 OpenAPI snapshot 没有提供的端点、SDK 方法、版本、registry 发布状态或性能数据。

出处与当前 contract

包名、安装入口、仓库、Docs、Reference 和 OpenAPI 链接来自本仓 locales/product-facts.json。上方导入名和调用模式读取自官方 Python SDK 源码修订；本指南刻意不声明包版本或 registry 发布状态。更新生成 client 代码前，请查看当前API Reference和 OpenAPI snapshot。

禁止真实资金 RTA

Pokerai API 仅用于训练、教学、手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助。不要将 SDK 输出接入 live-table automation，也不要将混合频率展示为实时行动指令。

相关公开操作

从已文档化的翻前预解查询开始；选择其他操作前先查看当前 Reference 和 OpenAPI snapshot。

端点SDK 封装用途
POST /v1/gto/prefloppreflop_strategy.sync一次已认证的翻前预解策略查询

SDK、API 与出处链接