← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. Pokerai Python SDK로 첫 요청을 보내려면 어떻게 하나요?
빠른 시작 여기서 시작 · 03/06 Python 10 분 초급

Pokerai Python SDK로 첫 요청을 보내려면 어떻게 하나요?

pokerai-bet를 설치하고 pokerai를 import한 다음, 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에서 가져왔습니다. 위의 import 이름과 호출 패턴은 공식 Python SDK 소스 리비전에서 확인했습니다. 이 가이드는 의도적으로 패키지 버전이나 레지스트리 게시 상태를 주장하지 않습니다. 생성된 클라이언트 코드를 업데이트하기 전에 최신 API 참조 및 OpenAPI 스냅샷을 확인하세요.

실제 현금 실시간 보조(RTA) 금지

Pokerai API는 훈련, 코칭, 핸드 리뷰, 학습 및 연구 목적으로만 사용할 수 있습니다. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. SDK 출력을 라이브 테이블 자동화에 사용하지 말고, 혼합 빈도를 실시간 액션 지시로 제시하지 마세요.

관련 공개 작업

문서화된 사전 풀이된 프리플랍 조회부터 시작하세요. 다른 작업을 선택하기 전에 현재 API 참조 및 OpenAPI 스냅샷을 사용하세요.

엔드포인트SDK 래퍼사용 용도
POST /v1/gto/prefloppreflop_strategy.sync인증된 사전 풀이된 프리플랍 전략 1회 조회

SDK, API 및 출처 링크