← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. API에서 프리플랍 전략을 어떻게 가져오나요?
가이드 GTO 전략 · 06/06 레인지 도구 12 분 초급

API에서 프리플랍 전략을 어떻게 가져오나요?

히어로의 두 카드, 히어로의 포지션, 그리고 히어로 이전의 모든 프리플랍 액션을 포함해 POST /v1/gto/preflop를 호출하세요. Pokerai API는 상황을 도출하고 해당 핸드의 JSON 전략 분포를 반환합니다.

업데이트됨 관리 주체 Pokerai API

직접 답변: API 키로 인증하고, hole_cards, positions.hero, 전체 preflop_actions 시퀀스를 전송한 다음, 선택적으로 preflop_version을 선택하세요. strategy의 각 항목은 권장 액션이 아니라 빈도로 해석하세요.

핵심 정보

엔드포인트POST /v1/gto/preflop
필수 입력hole_cards, positions.hero 및 preflop_actions
출력도출된 situation, 혼합 strategy[], 그리고 현재 quota 사용량
할당량각 호출에는 일반 사전 풀이된 조회 1회가 부과되며, 실시간 풀이 할당량은 사용하지 않습니다
용도훈련, 학습, 코칭, 핸드 리뷰 및 연구 — 실제 돈이 걸린 게임에서의 실시간 지원(RTA)에는 절대 사용하지 마세요

프리플랍 요청 구성

액션 라인은 명시적이며 순서가 있습니다. 블라인드 납부부터 시작해 히어로 이전의 모든 폴드, 콜, 레이즈를 포함하고 히어로가 행동하기 전에 멈춥니다. preflop_actions에 히어로를 포함하지 마세요.

필드전송할 내용
hole_cards"AhKh"처럼 구분자 없이 하나의 문자열로 된 정확히 두 장의 카드입니다.
positions.hero현재 6맥스 포지션 세트에서 히어로의 좌석: SB, BB, UTG, MP, CO 또는 BTN.
preflop_actions히어로 이전의 전체 시퀀스입니다. 각 항목에는 position 및 action이 있으며, 폴드 이외의 액션에는 누적 합계가 아닌 BB 단위로 새로 투자한 amount가 포함됩니다.
preflop_version선택 사항인 차트 세트 ID입니다. 플랫폼 기본값을 사용하려면 생략하거나 GET /v1/gto/preflop/versions에서 반환된 ID를 사용하세요.

최소 curl 요청

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

실제 응답 읽기

이 캡처된 응답은 위 요청과 일치합니다. 히어로는 MP에서 UTG 오픈에 맞서 AhKh를 보유하고 있습니다. situation은 액션 라인에서 파생되며, quota는 이 키의 월간 사용량을 보고합니다.

{"hole_cards": "AhKh", "situation": "Raise", "strategy": [{"action": "raise", "frequency": 1, "amount_bb": 9, "sizing_pot": 0.8}], "quota": {"used": 7, "limit": 100}}

혼합 빈도 작동 방식

각 frequency는 0에서 1 사이의 확률이며, 해당 핸드의 액션 빈도 합계는 일반적으로 약 1입니다. 위 응답처럼 일부 핸드는 순수하고, 다른 핸드는 실제로 혼합됩니다.

예를 들어, 2.5BB UTG 오픈에 맞선 MP의 9h9s에 대해 캡처된 응답은 폴드 0.254, 콜 0.106, 레이즈 0.64를 반환했습니다. 이는 폴드 25.4%, 콜 10.6%, 레이즈 64%를 의미합니다. API는 분포를 제공할 뿐, 권장 액션을 보장하거나 선택하지 않습니다.

amount_bb의 의미

반환된 레이즈의 경우 amount_bb는 빅 블라인드 기준으로 까지 레이즈할 절대 금액입니다. 이는 요청의 액션 히스토리에서 사용되는 증분 amount가 아닙니다.

히어로 이전 레이즈도출된 스팟amount_bb
0오픈3
13-벳9
24-벳25
3회 이상5-벳+100과 함께 allin: true

preflop_version을 안전하게 선택

선택 사항인 preflop_version은 프리플랍 차트 세트를 선택하며, 같은 상황도 버전에 따라 서로 다른 빈도를 가질 수 있습니다. 예시에서는 6max_RC_100bb_200NL을 사용하며, 이 필드를 생략하면 플랫폼 기본값이 선택됩니다.

GET /v1/gto/preflop/versions를 권위 있는 검색 엔드포인트로 간주하세요. 오늘의 ID, 스택 깊이 또는 형식이 영구적이라고 가정하지 말고 이 엔드포인트가 반환하는 ID를 사용하세요.

할당량 및 재시도

프리플랍 조회 한 번은 일반 사전 풀이된 조회 할당량 1회를 사용합니다. 응답의 quota.used 및 quota.limit는 해당 API 키의 현재 월간 카운터를 보여주며, 사용량은 대시보드에서도 확인할 수 있습니다.

할당량이 소진된 요청은 재시도하지 마세요. 월간 초기화를 기다리거나 사용 가능한 할당량을 변경하세요. API에 문서화된 일시적 실패에만 재시도 로직을 사용하세요.

일반적인 오류

HTTP오류원인 및 해결 방법
400invalid_hole_cardshole_cards에 유효한 카드 정확히 두 장을 보내세요.
400invalid_positions / invalid_actions문서화된 히어로 포지션과 블라인드 납부로 시작하는 완전하고 유효한 액션 시퀀스를 사용하세요.
400unsupported_preflop_versionGET /v1/gto/preflop/versions을 새로고침하고 반환된 ID 중 하나를 전달하세요.
401missing_api_key / invalid_api_keyAuthorization: Bearer 헤더에 유효한 API 키를 전송하세요.
404no_solution요청한 스팟에는 사전 풀이된 데이터가 없습니다. 변경 없이 재시도하지 말고 스팟을 확인하거나 변경하세요.
429quota_exceeded월간 일반 할당량이 소진되었습니다. 즉시 재시도해도 도움이 되지 않습니다.

사용해야 할 때와 사용하지 말아야 할 때

프리플랍 전략 조회는 트레이너, 학습 도구, 코칭 워크플로, 핸드 검토 대기열, 연구 및 오프라인 에이전트 분석에 사용하세요. 검토를 재현할 수 있도록 반환된 빈도를 버전 및 입력 스팟과 함께 저장하세요.

실제 금전이 걸린 테이블에서 실시간 지원을 위해 Pokerai API를 사용하지 마세요. 또한 혼합된 출력을 하나의 동작이 보장되거나 권장된다는 주장으로 바꾸지 마세요. 실제 금전이 걸린 테이블에서의 실시간 지원은 금지됩니다. 이용 약관을 참조하세요.

실제 금전이 걸린 테이블에서 실시간 지원을 위해 Pokerai API를 사용하지 말고, 혼합 출력을 한 가지 행동이 보장되거나 권장된다는 주장으로 바꾸지 마세요. 실제 금전 RTA는 이용 약관에 의해 금지됩니다.

참조, SDK 및 다음 단계