자주 묻는 질문
업데이트됨 2026년 7월 26일 · 관리 주체 Pokerai API · 출처 문서
Pokerai API란 무엇인가요?
직접 답변 6-max 노리밋 홀덤을 위한 셀프서비스 방식의 솔버급 GTO 전략 API입니다. 사전 계산된 풀이 결과에서 프리플랍과 플롭의 혼합 빈도 전략을 반환하며, 턴과 리버는 요청 시 풀이됩니다. 모든 요청은 상태 비저장이며 독립적으로 완결됩니다.
이런 경우에 사용 6-max NLHE 전략을 중심으로 교육, 코칭, 핸드 리뷰, 학습, 연구 또는 에이전트 워크플로를 구축하는 경우.
적합하지 않은 경우 PLO, ICM, 도박 거래 또는 실제 현금 테이블 지원.
GTO란 무엇인가요? GTO(게임 이론 최적)는 상대가 어떻게 조정하더라도 악용할 수 없는 전략입니다. 하나의 “최선” 수 대신, 각 스팟에는 특정 빈도의 균형 잡힌 액션 조합이 있으며, Pokerai API가 바로 이를 반환합니다.
솔버란 무엇인가요? 두 플레이어의 전략이 더 이상 개선되지 않을 때까지 반복(반사실적 후회 최소화, CFR)하여 특정 상황의 GTO 전략을 계산하는 소프트웨어입니다 — 즉, 균형점에 수렴합니다. 풀이는 연산량이 많으므로 Pokerai는 수백만 개의 사전 풀이된 상황을 즉시 제공하고 나머지는 요청 시 풀이합니다.
왜 하나의 ‘최선’ 수 대신 빈도를 사용하나요? 하나의 고정된 행동은 상대에게 공략당할 수 있기 때문입니다. GTO는 혼합 을 통해 균형을 유지합니다. 예를 들어 오픈에 맞서는 99는 64% 레이즈, 11% 콜, 25% 폴드를 할 수 있습니다. 상대가 당신을 파악할 수 없도록 그 빈도에 따라 무작위화합니다(시계, 주사위 또는 자신만의 방식).
“동형 보드”란 무엇인가요? 수트 이름만 다시 붙인 경우까지 동일한 보드입니다 — A♠K♠2♠와 A♥K♥2♥는 동일하게 플레이됩니다. 이러한 수트 대칭 중복을 하나의 표준 보드로 통합하기 때문에 약 66K개의 동형 플롭 스팟이 모든 실제 플롭을 포괄하면서 사전 계산된 데이터베이스를 작고 빠르게 유지할 수 있습니다.
어떤 형식과 스트리트를 지원하나요?
직접 답변 네 개의 모든 스트리트에 걸친 6-max NLHE: 프리플랍과 플롭은 사전 계산된 풀이를 사용하고, 턴과 리버는 요청 시 풀이됩니다. PLO와 ICM은 지원되지 않습니다.
이런 경우에 사용 문서화된 GTO 엔드포인트를 사용할 수 있는 6맥스 노리밋 홀덤 전략 워크플로.
적합하지 않은 경우 PLO, ICM 또는 지원되지 않는 포커 형식.
Pokerai API는 데스크톱 솔버 다운로드인가요?
직접 답변 아니요. Pokerai API는 문서화된 전략 데이터를 위한 호스팅 HTTP API입니다. 로컬 트리 구축 또는 연구 제어가 필요하면 데스크톱 솔버 소프트웨어를 사용하고, 에이전트를 평가하거나 게임을 시뮬레이션해야 하면 벤치마크 또는 게임플레이 API를 사용하세요.
이런 경우에 사용 문서화된 전략 데이터를 훈련, 검토, 연구 또는 에이전트 워크플로에 통합하는 것.
적합하지 않은 경우 로컬 솔버 소프트웨어 다운로드, 데스크톱 솔버 순위 평가 또는 벤치마크/게임플레이 결과를 GTO 전략 출력으로 취급하는 경우.
어떤 스택 깊이를 이용할 수 있나요? 프리플랍 차트 버전을 통해 선택할 수 있는 여러 깊이(예: 100bb, 40bb)가 있습니다. 목록을 보려면 GET /v1/gto/preflop/versions를 호출하세요.
어떻게 인증하나요?
직접 답변 Authorization: Bearer <API_KEY> 헤더를 보내세요. /login 에서 무료 키를 받으세요 — 신용카드가 필요 없습니다.
이런 경우에 사용 서버, SDK 또는 MCP 구성에서 인증된 공개 API 엔드포인트를 호출하는 경우.
적합하지 않은 경우 브라우저로 제공되는 클라이언트 코드에 API 키를 삽입하거나 이를 공개적으로 공유하는 행위.
할당량은 어떻게 작동하나요?
직접 답변 각 키에는 사전 계산된 프리플랍/플롭 조회와 실시간 턴/리버 풀이를 위한 독립적인 월별 카운터가 있습니다. 카운터를 모두 소진하면 HTTP 402 quota_exceeded가 반환됩니다.
이런 경우에 사용 키의 사용량을 추정하고 통합에서 할당량 소진 응답을 처리하는 작업.
적합하지 않은 경우 한 카운터의 사용하지 않은 용량을 다른 카운터로 이전할 수 있다고 가정하는 것.
어떤 호출이 무료인가요? 풀이가 완료된 스팟의 트리/노드(/solver/tree, /solver/node), 노드 EV(/evs), 플롭 노드(/flop/node)를 읽고 캐시됨 상태의 풀이를 재사용하는 작업입니다. /v1/gto/solver는 새로운 풀이를 트리거할 때만 요금이 부과됩니다.
단일 권장 액션을 반환하나요? 아니요. 각 액션(체크/콜/벳/레이즈/폴드)의 GTO 빈도 를 반환하므로, 항상 하나의 수를 선택하는 대신 자체 전략에 따라 무작위화합니다.
요청은 상태 비저장인가요? 내 핸드를 저장하나요? 요청은 상태 비저장이며 자체 완결형입니다. API는 전송하는 핸드/스팟을 저장하지 않습니다 — 계정 이메일과 키별 사용량만 저장합니다.
실시간 지원(RTA)에 사용할 수 있나요?
직접 답변 아니요. 실제 현금 테이블에서의 RTA는 금지됩니다. Pokerai API는 훈련, 코칭, 핸드 리뷰, 학습 및 연구용입니다.
이런 경우에 사용 오프라인 학습, 코칭, 핸드 후 리뷰, 연구 및 훈련 제품.
적합하지 않은 경우 실제 현금 테이블에서 플레이 중 실시간 지원.
무료 티어가 있나요?
직접 답변 예. 무료 티어에는 월별 사전 계산된 조회 1,000회와 실시간 풀이 25회가 포함되며, 신용카드는 필요하지 않습니다.
이런 경우에 사용 공개된 Free 월간 할당량 내에서 문서화된 API 워크플로를 시도하는 것.
적합하지 않은 경우 게시된 카운터를 초과하는 프로덕션 사용량까지 Free 용량으로 충당된다고 가정하는 경우.
속도는 얼마나 빠른가요? 프리플랍과 플롭은 밀리초 내에 제공됩니다. 턴/리버는 요청 시 풀이됩니다: /v1/gto/solver에 제출하고, 조회 가능해질 때까지 /v1/gto/solver/tree를 폴링한 다음 읽으세요 — 사용 가능 → 계산 중 → 조회 가능 상태 머신입니다.
OpenAPI 사양과 대화형 레퍼런스가 있나요?
이런 경우에 사용 문서화된 작업을 확인하거나 공개 API 계약에서 클라이언트를 생성하는 경우.
적합하지 않은 경우 문서화되지 않은 엔드포인트나 필드를 지원되는 것으로 간주하는 경우.
SDK 또는 MCP 서버를 제공하나요?
직접 답변 예. 공식 클라이언트는 Python용 pokerai-bet, TypeScript용 @pokerai/client, AI 에이전트용 @pokerai/mcp이며, 다른 클라이언트는 공개 OpenAPI 계약에서 생성할 수 있습니다.
이런 경우에 사용 명시된 공식 클라이언트 패키지 또는 OpenAPI로 생성된 클라이언트를 통해 통합하는 경우.
적합하지 않은 경우 목록에 없는 패키지가 공식이거나 문서화되지 않은 API 동작을 지원한다고 가정하는 행위.
보안 문제는 어떻게 신고하나요? security@pokerai.bet 로 이메일을 보내세요. 취약점 세부 정보, API 키, 인증 헤더 또는 개인 데이터를 Telegram, Discord, GitHub 또는 다른 공개 채널에 게시하지 마세요.