← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. Pokerai Python SDKで最初のリクエストを行うにはどうすればよいですか？
クイックスタート ここから始める · 03/06 Python 10 分 初心者

Pokerai Python SDKで最初のリクエストを行うにはどうすればよいですか？

pokerai-betをインストールし、pokeraiをインポートして、APIキーでAuthenticatedClientを作成し、POST /v1/gto/preflop用にドキュメント化されたSDKラッパーを呼び出します。

更新日 管理元 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 は API キーを Bearer トークンとして送信します。キーは ダッシュボードへのサインイン から作成してください。
レスポンスsituation、strategy、quotaを含む型付きのプリフロップレスポンス、またはドキュメント化されたエラーモデル
無料枠月あたり事前解析済みの照会1,000件 + リアルタイム解析25件。このリクエストは事前解析済みの照会1件です
利用範囲トレーニング、コーチング、ハンドレビュー、学習、研究のみ。リアルマネーでのリアルタイム支援 (RTA) は不可

インストールと認証

承認済みの製品情報に記載されたパッケージをインストールし、次にローカルで API キーをエクスポートします。実際のキーをコミットしたり、ブラウザコードに配置したり、ログに出力したりしないでください。

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

最小限の Python SDK リクエスト

これは、公開プリフロップ戦略操作向けの公式SDKクライアントパターンです。リクエスト形式、エンドポイント、成功以外のステータスコードは、現在のOpenAPIスナップショットで定義されています。

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があり、ベットまたはレイズ項目ではsizing_pot、amount_bb、allinも公開される場合があります。頻度の集合は、学習またはサンプリング対象となる混合分布として扱ってください。利益を保証するものでも、推奨される単一のアクションでもありません。

レスポンスには quota も含まれる場合があります。クライアント側のカウンターから推測するのではなく、返された結果またはダッシュボードでアカウント使用量を記録してください。ハードコードされた SDK の想定ではなく公開コントラクトが、現在のレスポンス形式の根拠であり続けます。

エラーとクォータの処理

この操作の公開契約では、400、401、429が宣言されています。生成されたSDKのsync呼び出しは、ドキュメント化されたエラーレスポンスをそのエラーモデルに解析します。アプリケーションでHTTPステータスとヘッダーも必要な場合は、sync_detailedを使用してください。無効な入力は変更せずに再試行するのではなく修正してください。認証情報がない、または無効な場合はBearerキーを確認してください。429の場合は、アカウントのクォータと現在のクォータに関するドキュメントを確認してください。

使用する場面

このSDKパターンは、サーバー側のトレーナー、コーチング製品、完了したハンドのレビュー用ツール、学習ワークフロー、研究プロジェクト、または人間によるレビューを伴うAIエージェント統合で使用できます。公開API契約に対する検証を続けながら型付きリクエストおよびレスポンスモデルを利用したい場合に、簡潔な方法です。

使用しない場合

APIキーを露出させるブラウザコード、ライブテーブルフィード、またはアクション自動化ループで、この例を使用しないでください。現在の公開ソースおよびOpenAPIスナップショットに記載されていないエンドポイント、SDKメソッド、バージョン、レジストリ公開、またはパフォーマンスに関する主張へのサポートを推測しないでください。

出所と現行の契約

パッケージ名、インストール項目、リポジトリ、ドキュメント、リファレンス、および OpenAPI リンクは、このリポジトリの locales/product-facts.json に由来します。上記のインポート名と呼び出しパターンは、公式の Python SDK ソースリビジョン から読み取りました。このガイドでは、パッケージバージョンやレジストリでの公開状態を意図的に主張していません。生成クライアントコードを更新する前に、現在の API リファレンス と OpenAPIスナップショットを確認してください。

リアルマネーでのリアルタイム支援 (RTA) なし

Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究のみを目的としています。リアルマネーのテーブルでのリアルタイム支援は禁じられています。SDK の出力をライブテーブルの自動化に使わず、混合頻度をリアルタイムのアクション指示として提示しないでください。

関連する公開操作

文書化された事前解析済みのプリフロップ検索から始め、別の操作を選択する前に現在のリファレンスとOpenAPIスナップショットを使用してください。

エンドポイントSDKラッパー用途
POST /v1/gto/prefloppreflop_strategy.sync認証済みの事前解析済みプリフロップ戦略の検索1件

SDK、API、出所リンク