よくある質問
更新日 · メンテナンス担当 Pokerai API · 出典 ドキュメント
Pokerai API とは何ですか？
- 直接の回答
- 6-max ノーリミットホールデム向けのセルフサービス型、ソルバー品質のGTO戦略APIです。プリフロップとフロップについては事前計算済みソリューションからミックス頻度の戦略を返し、ターンとリバーはオンデマンドで解析します。すべてのリクエストはステートレスかつ自己完結型です。
- このような場合に使用
- 6-max NLHE戦略に関するトレーニング、コーチング、ハンドレビュー、学習、研究、またはエージェントのワークフローを構築する場合。
- 対象外
- PLO、ICM、ギャンブル取引、またはリアルマネーテーブルでの支援。
GTOとは？
GTO（ゲーム理論最適）は、相手がどのように調整しても搾取されない戦略です。1つの「最善」アクションではなく、各スポットには特定の頻度でバランスよく組み合わせられたアクションがあります。これはPokerai APIが返すものそのものです。
ソルバーとは何ですか？
特定のスポットにおけるGTO戦略を、両プレイヤーの戦略が改善しなくなるまで反復処理（反実仮想的後悔最小化、CFR）して計算するソフトウェアです。つまり、均衡に収束するまで計算します。解析は計算負荷が高いため、Pokeraiは数百万件の事前解析済みスポットを即座に提供し、残りはオンデマンドで解析します。
なぜ「最善」の1手ではなく頻度を使うのですか？
単一の固定アクションは搾取され得るからです。GTOはミックスすることでバランスを保ちます。たとえば、オープンに直面した99は、64%でレイズ、11%でコール、25%でフォールドする場合があります。相手に読まれないよう、それらの頻度に従って（時計、サイコロ、独自の方法で）ランダム化します。
「同型ボード」とは？
スートの名称を付け替えても同一となるボードです。A♠K♠2♠ と A♥K♥2♥ は同じようにプレーされます。このようなスート対称の重複を 1 つの正規ボードにまとめることで、約 66K の同型フロップスポットが実際のすべてのフロップをカバーでき、事前解析済みデータベースを小さく高速に保てます。
どの形式とストリートをカバーしていますか？
- 直接の回答
- 4ストリートすべての6-max NLHE：プリフロップとフロップでは事前に解析された解を使用し、ターンとリバーではオンデマンドで解析します。PLOとICMは対象外です。
- このような場合に使用
- 文書化されたGTOエンドポイントを利用できる、6-max ノーリミットホールデム戦略のワークフロー。
- 対象外
- PLO、ICM、またはサポートされていないポーカーフォーマット。
Pokerai API はデスクトップソルバーのダウンロードですか？
- 直接の回答
- いいえ。Pokerai APIは、文書化された戦略データのためのホスト型HTTP APIです。ローカルでツリーを構築したり研究を管理したりする必要がある場合はデスクトップソルバーソフトウェアを使用し、エージェントを評価したりゲームをシミュレートしたりする必要がある場合はベンチマークまたはゲームプレイAPIを使用してください。
- このような場合に使用
- 文書化された戦略データを、トレーニング、レビュー、研究、またはエージェントのワークフローに統合すること。
- 対象外
- ローカルのソルバーソフトウェアをダウンロードすること、デスクトップソルバーをランキングすること、またはベンチマーク／ゲームプレイの結果をGTO戦略の出力として扱うこと。
どのスタック深度を利用できますか？
複数のスタック深さ（例：100bb、40bb）があり、プリフロップチャートのバージョンで選択します。一覧を取得するには GET /v1/gto/preflop/versions を呼び出してください。
認証するにはどうすればよいですか？
- 直接の回答
Authorization: Bearer <API_KEY> ヘッダーを送信してください。/login で無料のキーを取得できます。クレジットカードは不要です。- このような場合に使用
- サーバー、SDK、または MCP 設定から、認証済みの公開 API エンドポイントを呼び出すこと。
- 対象外
- ブラウザに配信されるクライアントコードにAPIキーを埋め込むこと、またはAPIキーを公開して共有すること。
クォータはどのように機能しますか？
- 直接の回答
- 各キーには、事前解析済みのプリフロップ／フロップのルックアップとリアルタイムのターン／リバー解析に対して、独立した月次カウンターがあります。カウンターを使い切ると
HTTP 402 quota_exceeded が返されます。
- このような場合に使用
- キーの使用量を見積もり、統合内でクォータ枯渇時のレスポンスを処理すること。
- 対象外
- 一方のカウンターで未使用の容量を、もう一方に移せると想定すること。
無料の呼び出しはどれですか？
解析済みスポットのツリー／ノード（/solver/tree、/solver/node）、ノードEV（/evs）、フロップノード（/flop/node）の読み取り、およびキャッシュされた解析結果の再利用。/v1/gto/solverは、新しい解析を実行した場合にのみ課金されます。
単一の推奨アクションを返しますか？
いいえ。各アクション（チェック／コール／ベット／レイズ／フォールド）のGTO 頻度が返されるため、常に1つの手を選ぶのではなく、自身の戦略に従ってランダム化します。
リクエストはステートレスですか？ハンドは保存されますか？
リクエストはステートレスで自己完結しています。API は送信したハンド／スポットを保存しません。保存するのはアカウントのメールアドレスとキーごとの使用回数のみです。
リアルタイム支援（RTA）に使用できますか？
- 直接の回答
- いいえ。リアルマネーテーブルでの RTA は禁止されています。Pokerai API は、トレーニング、コーチング、ハンドレビュー、学習、研究を目的としています。
- このような場合に使用
- オフラインでの学習、コーチング、ハンド後のレビュー、研究、トレーニング製品。
- 対象外
- リアルマネーテーブルでのプレイ中にリアルタイム支援を受けること。
無料のティアはありますか？
- 直接の回答
- はい。無料プランには、事前解析済みの検索が1,000回とリアルタイム解析が月25回含まれており、クレジットカードは不要です。
- このような場合に使用
- 公開されている無料プランの月間割り当ての範囲内で、文書化された API ワークフローを試すこと。
- 対象外
- 公開されたこれらのカウンターを超える本番利用も無料枠の容量でカバーできると想定すること。
どのくらい速いですか？
プリフロップとフロップはミリ秒単位で提供されます。ターン/リバーはオンデマンドで解析されます。/v1/gto/solver に送信し、クエリ可能になるまで /v1/gto/solver/tree をポーリングしてから読み取ります。状態遷移は 利用可能 → 処理中 → クエリ可能 です。
OpenAPI 仕様とインタラクティブなリファレンスはありますか？
- このような場合に使用
- 文書化された操作を確認する、または公開 API 契約からクライアントを生成すること。
- 対象外
- 文書化されていないエンドポイントやフィールドをサポート対象として扱うこと。
SDKまたはMCPサーバーはありますか？
- 直接の回答
- はい。公式クライアントは、Python 向けの pokerai-bet、TypeScript 向けの @pokerai/client、AI エージェント向けの @pokerai/mcp です。その他のクライアントは、公開 OpenAPI 契約から生成できます。
- このような場合に使用
- 記載されている公式クライアントパッケージ、またはOpenAPIで生成されたクライアントを通じた統合。
- 対象外
- 一覧にないパッケージが公式である、または文書化されていない API の動作をサポートしていると想定すること。
セキュリティ上の問題を報告するにはどうすればよいですか？
security@pokerai.bet にメールしてください。脆弱性の詳細、API キー、認証ヘッダー、個人データを Telegram、Discord、GitHub、またはその他の公開チャネルに公開しないでください。