GTO ソルバーのワークフローを実行するには？
カスタムのフロップ、ターン、またはリバーの解析を作成し、クエリ可能になるまでそのツリーをポーリングしてから、完了したノードの戦略をリクエストします。
POST /v1/gto/solver を呼び出し、返された solve ハンドルを保持します。spot_status が queryable になるまで POST /v1/gto/solver/tree をポーリングし、その後、返されたノードの token を POST /v1/gto/solver/node に渡します。概要
| 項目 | 値 |
|---|---|
| 作成 | POST /v1/gto/solver はフロップ、ターン、またはリバーの解析を予約します。ボードの長さによってストリートが選択されます。 |
| 準備状況 | spot_status が queryable になるまで POST /v1/gto/solver/tree をポーリングします。 |
| 読み取り | ツリーノードの token を POST /v1/gto/solver/node に渡します。 |
| クォータ | 新規解析は解析クォータを1つ使用します。キャッシュの再利用、ツリーの読み取り、ノードの読み取りは解析クォータを消費しません。 |
| 無料枠 | 月あたり事前解析済みの検索1,000回 + リアルタイム解析25回。 |
これを使用する場合
このワークフローは、ボード、レンジ、ポット、有効スタック、ヒーローのポジションを送信する必要があるカスタムのフロップ、ターン、またはリバーのスポットに使用します。これは送信した1つの解析ハンドルのライフサイクルであり、すべてのポーカーフォーマットや結果品質に関する主張ではありません。
これを使用しない場合
リアルマネーでのリアルタイム支援 (RTA) には使用しないでください。Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究用です。computing、expired、no_nodes、またはノードの error レスポンスを、完了した戦略として扱わないでください。
検証可能な最小リクエスト
curl -s https://pokerai.bet/v1/gto/solver -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"board":"2c2h2s","oop_range":"AA,KK","ip_range":"QQ,JJ","pot":6,"effective_stack":100,"hero":"OOP"}'レスポンスの solve ハンドルを保存します。レスポンスは computing または queryable を報告することがあります。solve_quota を含むのは新規トリガーのみです。
ツリーをポーリングしてから、完了したノードを読み取る
curl -s https://pokerai.bet/v1/gto/solver/tree -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"solve":"<解析ハンドル>"}'curl -s https://pokerai.bet/v1/gto/solver/node -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"node":"<クエリ可能なツリーのノードトークン>"}'ヒーローノードでは、文書化された成功時の形式に strategy があります。相手ノードの場合、または hole_cards が省略された場合、文書化されたレスポンスで actions と range_strategy が提供されることがあります。現在の OpenAPI コントラクトで文書化されているフィールドだけを使用してください。
ステータスとエラー処理
| シグナル | 意味 | 対応 |
|---|---|---|
computing | 解析またはノードはまだ処理中です。 | ツリーを再度ポーリングし、完了したものとして戦略を要求しないでください。 |
queryable | ツリーは確認できる状態です。 | 返されたノードトークンを選択し、/v1/gto/solver/node を呼び出します。 |
no_nodes | 照会されたラウンドまたはランアウトには意思決定ノードがありません。 | そのラウンドまたはランアウトのポーリングを停止します。 |
expired | 解析結果は回収または置換されました。 | 新規解析を予約してください。古いハンドルは照会できません。 |
error | ノードは、必要に応じて message を伴う戦略エラーを報告します。 | 失敗したノードとして処理し、戦略として提示しないでください。 |
HTTP 429（status: busy） | すべてのソルバーホストがビジー状態です。 | バックオフして再試行してください。これはクォータの消費ではありません。 |
HTTP 503 | ツリーまたはノードのアップストリームが利用できません。 | 一時的なものとみなし、適切な場合はバックオフして再試行してください。 |
クォータと関連リソース
新規解析はリアルタイム解析カウンターを消費します。キャッシュ済み解析の再利用とソルバーツリー／ノードの読み取りは無料です。現在の月次カウンターについては、クォータのトピックを参照してください。
- ドキュメントハブ — API の概念と認証。
- クォータ — 無料枠の上限と
busyの処理。 - API リファレンス — 現在のソルバー操作スキーマ。
- OpenAPI スナップショット — 機械可読なソルバーライフサイクルコントラクト。
- GTO ソルバー API ガイド — 関連する実装ガイド。
- Python SDK、TypeScript / JavaScript SDK、MCP サーバー — 公式パッケージのエントリポイント。
Real-time assistance at real-money tables is prohibited.