PokerKit API でボードテクスチャを分析するには?
フロップ、ターン、またはリバーのボードを POST /v1/pokerkit/texture に送信して、そのボード用に文書化されたカテゴリ別テクスチャおよびスート形状フィールドを受け取ります。
AsKsQs のように区切りなしの1つの文字列として board に指定し、POST /v1/pokerkit/texture に送信します。返された result はボード説明フィールドとして読み取ってください。エクイティ、GTO戦略、またはライブプレイ中のアクション推奨ではありません。概要
| エンドポイント | POST /v1/pokerkit/texture |
|---|---|
| 必須入力 | board: 3枚、4枚、または5枚のコミュニティカードを区切りなしで連結した文字列。例: AsKsQs |
| 任意の入力 | hand_type および dead(公開OpenAPIスキーマで定義) |
| レスポンス | カード、カテゴリ別テクスチャフィールド、およびスート形状の真偽値を含む result オブジェクト |
| 利用範囲 | トレーニング、コーチング、ハンドレビュー、学習、研究専用。リアルマネーでのリアルタイム支援 (RTA) は禁止です |
入力の意味
board は必須です。標準的な2文字のカードコードを区切り文字なしで連結します。3枚はフロップ、4枚はターン、5枚はリバーを表します。公開スキーマでは任意の hand_type と dead も利用できますが、文書化されたワークフローで必要な場合を除き省略してください。このエンドポイントにホールカードを送信しないでください。これはプレイヤーのハンドではなく、ボードを表します。
最小リクエスト
JSON と API キーを使用します。このリクエスト本文と以下のレスポンスは、公開されている pokerkitTexture のドキュメント用コード例です。
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'
レスポンスの解釈
{"result":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"connectivity":{"name":"HIGH","value":"High"},"rank_band":{"name":"HIGH","value":"High"},"straight_draw":{"name":"OPEN_ENDED","value":"Open-ended"},"flush_draw":{"name":"LIVE","value":"Live"},"are_two_tone":false,"are_monotone":true,"are_rainbow":false}}
cards は、指定したボードを配列に正規化します。wetness、connectivity、rank_band、straight_draw、flush_draw は、name と表示用の value を持つカテゴリ記述子です。3つのブール値は、返されるボードのスート構成を表します。この例では are_monotone は true で、are_two_tone と are_rainbow は false です。これらのラベルはこの入力を説明するものであり、エクイティを計算したり、ポーカーのアクションを選択したりするものではありません。
使用する場面
トレーニング、コーチング、または完了したハンドのレビューのワークフローで、他の文書化された分析を提示する前に一貫したボードの説明が必要な場合は、Texture を使用してください。統合されたボード概要が必要な場合は、別途公開されている POST /v1/pokerkit/board-report の仕様を確認してください。プレイヤー固有の分析が必要な場合は、代わりに公開されている ハンドレポート、ドロー、アウト、またはブロッカーの仕様を確認してください。
使用すべきでない場面
テクスチャラベルを、エクイティの推定値、ソルバーの解析結果、ハンドの強さの保証、または推奨アクションとして扱わないでください。Texture は、文書化されたエクイティ、GTO、またはプレイヤーハンドのエンドポイントへのリクエストに代わるものではなく、リアルマネーでのライブ意思決定支援に使用してはなりません。
クォータとエラー
このエンドポイントは、公開 PokerKit API と同じ API キーおよびアカウントクォータのシステムを使用します。クライアントに上限をハードコーディングするのではなく、現在のアカウント上限と使用量について、クォータのドキュメント、料金、ダッシュボードを確認してください。
| シグナル | 意味 | 対応方法 |
|---|---|---|
| 422 | 公開 OpenAPI 仕様では、バリデーションエラーのレスポンスが定義されています。 | 現在のリファレンスまたは OpenAPI スキーマに照らして board と任意のフィールドを確認し、リクエストを修正してください。 |
| その他の API エラー | 認証とアカウントクォータの処理は API レベルで文書化されています。 | 現在のエラーのドキュメントとダッシュボードのステータスを使用してください。変更されていない無効なリクエストを再試行しないでください。 |
SDK、MCP、関連リソース
- 開発者向けドキュメント — 認証とクォータに加え、公式 SDK と MCP のセットアップを案内します。
- API リファレンス — 現在の Texture のリクエストおよびレスポンスの仕様を確認します。
- OpenAPIスナップショット — 機械可読な英語の仕様です。
- Python SDK、TypeScript / JavaScript SDK、MCP サーバー — 公式パッケージのエントリポイントです。
- ポーカーハンドレビュー API ガイド — ボードの意味をセッション後のワークフローに組み込みます。
- llms.txt — 簡潔な LLM エントリポイントです。