API로 포커 레인지를 처리하려면 어떻게 해야 하나요?

PokerKit 레인지 엔드포인트를 사용해 문서화된 표기법을 구체적인 콤보로 변환하고, 결정론적 레인지 속성을 살펴보거나 명시적인 몬테카를로 제어로 레인지 에퀴티를 추정하세요. 작업이 문서화된 솔버 레인지 워크플로라면 GTO 레인지 엔드포인트를 사용하세요.

업데이트됨 2026년 7월 26일관리 주체 Pokerai API

직접 답변: 표기법을 확장하려면 POST /v1/pokerkit/range/expand를 사용하세요. 결정론적 보드 기반 레인지 분석에는 /range/value 및 /range/nut-advantage를 사용하고, 몬테카를로 에퀴티 점유율 추정이 필요할 때는 /range/equity-advantage를 사용하세요. 솔버 기반 레인지에는 공개된 /v1/gto/range, /v1/gto/flop/projected-range 또는 /v1/gto/turn/projected-range 계약을 사용하세요.

핵심 정보

표기법	`["AA", "KQs"]`와 같은 PokerKit 레인지 표기법 배열이며, 확장하면 구체적인 두 카드 조합을 반환합니다.
결정론적	`range/expand`, `range/value`, 및 `range/nut-advantage`는 몬테카를로 샘플링을 사용하지 않습니다.
몬테카를로	`range/equity-advantage`는 문서화된 `sample_count` 및 `seed`를 허용하며, 시드는 재현 가능한 샘플링을 지원합니다.
할당량	결정론적 PokerKit 레인지 엔드포인트는 일반 할당량 1을 차감합니다. `range/equity-advantage`는 풀이 할당량 1을 차감합니다.
GTO 레인지	GTO 레인지 엔드포인트는 별도의 솔버 워크플로입니다. 현재 요청 및 응답 스키마는 API 참조 또는 OpenAPI 스냅샷에서 확인하세요.
사용 범위	훈련, 코칭, 핸드 검토, 학습 및 연구용이며, 실제 금전이 걸린 실시간 보조(RTA) 용도가 아닙니다.

레인지 표기법

표기법 문자열의 JSON 배열을 전달하세요. AA는 포켓 페어 핸드 클래스를 나타내고 KQs는 수티드 킹-퀸을 나타냅니다. 확장 응답에는 구체적인 카드 쌍이 나열됩니다. 결과를 해석할 수 있도록 표기법, 보드, 플레이어 순서를 저장된 검토 입력과 함께 보관하세요.

최소 검증 요청 및 응답

이 공개 문서 코드 예제는 POST /v1/pokerkit/range/expand를 호출합니다. Authorization: Bearer $POKERAI_API_KEY에 API 키를, JSON 콘텐츠 유형을 전송하세요.

{"notation": ["AA", "KQs"]}

{"result": [["Ac", "Ad"], ["Ac", "Ah"], ["Ac", "As"], ["Ad", "Ah"], ["Ad", "As"], ["Ah", "As"], ["Kc", "Qc"], ["Kd", "Qd"], ["Kh", "Qh"], ["Ks", "Qs"]]}

각 내부 배열은 하나의 구체적인 두 장 카드 콤보입니다. 이 응답은 제공된 표기법을 설명하며 GTO 액션 추천이 아닙니다.

레인지 작업 선택

필요한 작업	공개 엔드포인트	방법
표기법 확장	`POST /v1/pokerkit/range/expand`	결정론적 콤보 확장.
보드에서 밸류 레인지 구축	`POST /v1/pokerkit/range/value`	`aggression` 또는 `floor`를 사용하는 결정론적 메이드 카테고리 하한.
넛 점유율 비교	`POST /v1/pokerkit/range/nut-advantage`	결정론적 콤보 수 기반 넛 점유율 분할.
에퀴티 점유율 비교	`POST /v1/pokerkit/range/equity-advantage`	제공된 두 레인지에 대한 몬테카를로 추정치. `sample_count`와 `seed`는 문서화된 방식으로만 사용하세요.
솔버 레인지 진행	`POST /v1/gto/range`, `/flop/projected-range` 또는 `/turn/projected-range`	명시된 솔버 워크플로를 위한 공개된 GTO 레인지 계약.

결정론적 방식과 몬테카를로 방식

expand, value 또는 nut-advantage 결과를 시뮬레이션으로 표시하지 마세요. 이러한 작업은 제공된 입력에 대해 결정론적입니다. equity-advantage는 다릅니다. 이는 몬테카를로 방식이므로 결과는 제출된 레인지와 보드에 대한 추정치입니다. 고정된 seed는 샘플링을 재현 가능하게 만들지만 보편적으로 정확하게 만들지는 않습니다. 결과를 제시할 때 반환된 sample_count를 보존하세요.

할당량 및 오류

신호	의미	수행할 작업
401	`missing_api_key` 또는 `invalid_api_key`.	유효한 API 키 헤더를 전송하고 클라이언트 로그에 노출하지 마세요.
429	적용되는 월간 카운터가 소진되면 `quota_exceeded`.	재설정을 기다리거나 작업을 줄이세요. 변경되지 않은 요청을 재시도하지 마세요.
422	요청 유효성 검사가 실패했습니다.	엔드포인트의 최신 API 참조 또는 OpenAPI 스키마를 확인하고 본문을 수정하세요.

현재 카운터는 할당량 문서와 대시보드에서 확인하세요. GTO 레인지 엔드포인트는 자체 문서화된 할당량 동작을 따릅니다.

교육 및 검토 전용

Pokerai API는 교육, 코칭, 핸드 검토, 학습 및 연구에 사용하세요. 실머니 테이블에서의 실시간 보조(RTA)는 금지됩니다. 레인지 분석을 라이브 테이블 자동화에 연결하거나 실시간 액션 지침으로 제시하지 마세요.