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

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

安装 @pokerai/client，用 API key 创建 createPokeraiClient，再调用其类型化 POST 方法访问 /v1/gto/preflop。

更新于 维护者 Pokerai API

直接答案：使用 npm install @pokerai/client，将 POKERAI_API_KEY 保存在服务端环境变量中，创建 createPokeraiClient({ apiKey })，再调用 client.POST("/v1/gto/preflop", { body })。结果将解析后的 data 与类型化 error 分开；它不是实时牌局建议。

核心事实

官方包入口npm install @pokerai/client；从 @pokerai/client 导入 createPokeraiClient
首个 SDK 调用client.POST("/v1/gto/preflop", { body }) 调用已文档化的翻前预解操作
认证createPokeraiClient({ apiKey }) 通过 Bearer token 发送 key；从控制台登录创建 key
响应成功时 client 返回解析后的 data，失败时返回类型化 error；已文档化的成功字段包括 situation、strategy 与 quota
Free 额度1,000 次预解查询 + 25 次实时求解 / 月；该请求消耗 1 次预解查询
用途边界仅限训练、教学、手牌复盘、学习和研究；禁止真实资金 RTA

安装与认证

安装官方包后，只将 API key 提供给受信任的服务端代码。不要提交真实 key、不要将其打包进浏览器 JavaScript，也不要在日志中输出。

npm install @pokerai/client
export POKERAI_API_KEY="gto_your_key_here"

最小 JavaScript SDK 请求

此官方 SDK 模式调用公开翻前策略操作。请求结构、端点和非成功状态码由当前OpenAPI snapshot定义。

import { createPokeraiClient } from "@pokerai/client";

const client = createPokeraiClient({
  apiKey: process.env.POKERAI_API_KEY,
});

const { data, error } = await client.POST("/v1/gto/preflop", {
  body: {
    hole_cards: "AhKh",
    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: 3 },
    ],
  },
});

if (error) throw new Error(JSON.stringify(error));
console.log(data.situation, data.strategy);

如何解读响应

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

响应可包含 data.quota。请从返回结果或控制台记录账号用量，不要通过应用计数器推断。当前公开 contract 而非硬编码 SDK 假设，才是响应字段的依据。

错误和配额处理

该操作的公开 contract 声明 400、401 和 429。读取 data 前先检查 error。无效输入应先修正而不是原样重试；缺失或无效认证时检查服务端 Bearer key；429 时检查账号额度和当前配额文档。

何时使用

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

何时不应使用

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

出处与当前 contract

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

禁止真实资金 RTA

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

相关公开操作

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

端点SDK 调用用途
POST /v1/gto/preflopclient.POST("/v1/gto/preflop", { body })一次已认证的翻前预解策略查询

SDK、API 与出处链接