데스크톱 솔버 대신 호스팅된 포커 솔버 API를 언제 사용해야 하나요?
제품에서 문서화된 상태 비저장 전략 요청을 반복적으로 수행해야 한다면 호스팅된 솔버 API를 사용하세요. 연구가 맞춤 로컬 풀이 워크플로를 설계하고 검사하는 데 의존한다면 데스크톱 솔버를 사용하세요.
비교 가능한 사실
| 호스팅된 API 인터페이스 | 공개 OpenAPI 계약에 문서화된 Bearer 인증 방식의 상태 비저장 JSON 요청 및 응답 |
|---|---|
| 호스팅된 전략 접근 | 문서화된 엔드포인트를 통한 사전 풀이된 프리플랍 및 플롭 조회와 요청 시 맞춤 플롭, 턴 및 리버 풀이 |
| 데스크톱 솔버 워크플로 | 트리를 구성하고, 추상화와 사이징을 선택하고, 풀이를 실행하고, 그 출력을 검사하기 위한 로컬 연구 워크플로 |
| 재현성 경계 | 호출자가 전체 요청, 지원되는 경우 API 버전 또는 전략 버전, 그리고 반환된 응답을 보존할 때만 API 요청을 반복할 수 있습니다 |
| 허용된 사용 | 교육, 코칭, 핸드 리뷰, 학습 및 연구 — 실제 현금 테이블에서의 실시간 지원은 절대 금지 |
호스팅된 솔버 API가 더 적합한 경우는 언제인가요?
연구자의 데스크톱 세션이 아니라 제품 내부에서 소프트웨어에 전략이 필요하다면 호스팅된 API를 선택하세요. 예를 들어 핸드를 평가하는 트레이너, 핸드 리뷰 대기열, 레인지 시각화 도구, 백엔드 서비스 또는 사람의 검토가 있는 AI 에이전트가 해당합니다. 제품은 문서화된 하나의 엔드포인트를 호출하고 반환된 혼합 빈도, 레인지, 노드 또는 EV를 렌더링할 수 있습니다.
통합 경계는 명확합니다. 애플리케이션은 인증, 입력 유효성 검사, 자체 학습 기록의 저장 및 표시를 담당합니다. Pokerai API는 상태 비저장 스팟을 받아 JSON을 반환합니다. 애플리케이션이 솔버 바이너리를 배포하거나 로컬 솔버 트리를 운영할 필요는 없습니다.
데스크톱 솔버가 더 적합한 경우는 언제인가요?
주요 작업이 연구인 경우 데스크톱 솔버를 선택하세요. 새로운 게임 트리를 정의하고, 추상화와 베팅 크기를 선택하며, 로컬 실험을 실행하고, 결과 트리를 자세히 검토하는 작업이 이에 해당합니다. 이러한 선택은 풀이의 입력값이며, 호스팅된 API가 짧은 제품 요청만으로 추론할 수 있는 가정이 아닙니다.
고정된 학습 워크플로를 공개하기 전에 연구 구성을 비교하는 데에도 데스크톱 워크플로가 적합합니다. 전체 구성과 출력이 보존되고 비교된 경우가 아니라면, 호스팅된 응답을 별도로 구성한 로컬 풀이와 동등하다고 설명하지 마세요.
통합 및 재현성 경계
재현 가능한 API 기반 연구를 위해 엔드포인트, 전체 요청 본문, 엔드포인트가 제공하는 경우 전략 또는 API 버전, 요청 시간 및 반환된 응답을 기록하세요. 스팟에 대한 자연어 설명만 재현하는 것으로는 충분하지 않습니다. 포지션, 스택, 보드, 액션 라인, 사이징 선택 및 버전이 결과를 바꿀 수 있습니다.
온디맨드 풀이의 경우 트리, 노드 및 EV를 읽는 동안 풀이 핸들과 원래 구성을 유지하세요. 폴링 또는 노드 읽기는 해당 풀이를 확인하며, 새 제출은 별도의 풀이 요청입니다. 오래 보관할 연구 산출물이 필요하면 내보낸 입력과 출력을 자체 학습 시스템에 보관하세요.
안전한 사용 및 실시간 지원 금지
Pokerai API는 오프라인 훈련, 코칭, 핸드 리뷰, 학습 및 연구를 위한 것입니다. 실제 돈이 걸린 테이블에서의 실시간 지원은 금지됩니다.
해당 경계를 중심으로 제품 제어 기능을 구축하세요. 전략 기능은 학습 및 복기 맥락에 유지하고, 에이전트가 생성한 설명에는 사람의 검토를 요구하며, API 또는 데스크톱 워크플로를 라이브 플레이 조언으로 바꾸지 마세요.
통합 맵
공개 계약을 사용해 API 요청을 선택하고, 연구 구성 자체를 설계하는 것이 작업이라면 데스크톱 솔버를 사용하세요.
| API 영역 | 제품 작업 | 경계 |
|---|---|---|
POST /v1/gto/preflop | 하나의 프리플랍 상황을 평가하거나 표시 | 핸드, 포지션, 액션 라인에 대한 문서화된 요청이며, 맞춤형 로컬 트리 편집기가 아닙니다. |
POST /v1/gto/flop/tree | 사전 풀이된 플롭 워크플로 렌더링 | 요청한 포메이션과 보드에 대해 반환된 트리와 노드 토큰을 읽습니다. |
POST /v1/gto/solver | 요청 시 맞춤 스팟 제출 | 문서화된 구성을 제출한 다음, 해당 풀이를 검토하는 동안 핸들과 입력을 유지합니다. |
POST /v1/gto/solver/tree | 완료된 풀이 검사 | 제출된 풀이를 폴링하고 읽으세요. 이는 새로운 연구 트리 설계를 대체하지 않습니다. |
공식 통합 리소스
- 개발자 문서 — 인증, SDK, 할당량, 오류 및 엔드포인트 동작
- 대화형 API 참조 — 공개 엔드포인트의 요청 및 응답 스키마
- OpenAPI 명세 — 기계가 읽을 수 있는 영어 API 계약
- GTO 솔버 API 가이드 — 호스팅된 전략 API가 반환하는 항목
- Python SDK — 공식 타입 지정 Python 클라이언트
- JavaScript / TypeScript SDK — 공식 타입 지원 JavaScript 및 TypeScript 클라이언트
- MCP 서버 — 호환되는 에이전트를 위한 공식 Pokerai API 도구 서버
- llms.txt — Pokerai API를 위한 간결한 LLM 진입점