첫 GTO 포커 API 요청은 어떻게 하나요?

빠른 정보

이 빠른 시작을 사용해야 할 때

인증을 확인하고 응답 형식을 살펴보거나, 트레이너, 학습 도구, 핸드 검토 워크플로, 백엔드 서비스 또는 AI 에이전트 통합을 시작하는 데 사용하세요.

사용하지 말아야 할 때

실제 돈이 걸린 플레이 중 실시간 조언 용도로 이 엔드포인트를 사용하지 마세요. 맞춤형 플롭, 턴 또는 리버 트리의 경우, 이 프리플랍 조회를 일반적인 포스트플랍 솔버로 취급하지 말고 개발자 문서의 실시간 솔버 워크플로를 따르세요.

최소 curl 요청

키를 생성하고 로컬에 POKERAI_API_KEY로 저장한 다음 이 요청을 실행하세요. 실제 키를 커밋하거나 클라이언트 측 코드에 넣지 마세요.

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hole_cards": "9h9s",
    "positions": { "hero": "MP" },
    "preflop_actions": [
      { "position": "SB", "action": "small blind", "amount": 0.5 },
      { "position": "BB", "action": "big blind", "amount": 1 },
      { "position": "UTG", "action": "raise", "amount": 2.5 }
    ]
  }'

실제 응답

이 캡처된 응답은 2.5bb UTG 오픈 후 MP가 9h9s를 보유한 경우의 응답입니다:

{
  "hole_cards": "9h9s",
  "situation": "Raise",
  "strategy": [
    { "action": "fold", "frequency": 0.254 },
    { "action": "call", "frequency": 0.106 },
    { "action": "raise", "frequency": 0.64, "amount_bb": 9, "sizing_pot": 1 }
  ]
}

세 빈도의 합은 1입니다: 폴드 25.4%, 콜 10.6%, 9bb로 레이즈 64%. 이를 학습하거나 샘플링할 분포로 취급하고, 하나의 액션이 이긴다는 보장으로 취급하지 마세요.

할당량

Pokerai API는 사전 풀이 조회와 실시간 풀이를 별도로 측정합니다. 이 프리플랍 요청은 사전 풀이 조회 1회를 사용합니다. Free 티어에는 월간 사전 풀이 조회 1,000회와 실시간 풀이 25회가 포함됩니다. 두 카운터 모두 매월 재설정되며 현재 사용량은 대시보드에 표시됩니다. 현재 공개 한도는 가격에서 확인하세요.

일반적인 오류

이 엔드포인트의 공개 OpenAPI 계약은 다음 비성공 응답을 선언합니다:

SDK 및 MCP 옵션

공식 클라이언트는 동일한 공개 OpenAPI 계약을 따르며 동일한 API 키와 할당량을 사용합니다. 완전한 타입 지정 예제는 SDK 문서에 있습니다.

• Python SDK: pip install pokerai-bet (pokerai로 import).
• TypeScript / JavaScript SDK: npm install @pokerai/client.
• AI 에이전트를 위한 MCP 서버: npx @pokerai/mcp. 사전 풀이 도구는 기본적으로 활성화되어 있으며, 솔버 도구를 활성화하면 별도의 풀이 할당량이 소모됩니다.

실제 현금 RTA 없음