GTO 솔버 워크플로를 실행하려면 어떻게 해야 하나요?
맞춤 플롭, 턴 또는 리버 풀이를 생성하고, 트리가 쿼리 가능한 상태가 될 때까지 폴링한 뒤 완료된 노드의 전략을 요청하세요.
직접 답변:
POST /v1/gto/solver를 호출하고 반환된 solve 핸들을 보관한 다음, spot_status가 queryable이 될 때까지 POST /v1/gto/solver/tree를 폴링하세요. 그런 다음 반환된 노드 token을 POST /v1/gto/solver/node에 전달하세요. 503 upstream_unavailable은 서비스 자체 재시도 후에도 솔버 업스트림을 사용할 수 없는 상태로 남아 있음을 의미합니다. 동일한 요청을 제한된 지수 백오프로 재시도하되, 유효하지 않은 입력은 재시도하지 마세요.주요 정보
| 항목 | 값 |
|---|---|
| 생성 | POST /v1/gto/solver는 플롭, 턴 또는 리버 풀이를 예약합니다. 보드 길이로 스트리트를 선택합니다. |
| 준비 상태 | spot_status가 queryable이 될 때까지 POST /v1/gto/solver/tree를 폴링하세요. |
| 읽기 | 트리 노드 token을 POST /v1/gto/solver/node에 전달하세요. |
| 할당량 | 새 풀이 한 건은 풀이 할당량 한 건을 사용합니다. 캐시됨 상태의 재사용, 트리 읽기 및 노드 읽기는 풀이 할당량을 소모하지 않습니다. |
| 무료 등급 | 월 1,000회 사전 풀이된 조회 + 25회 실시간 풀이. |
사용 시점
보드, 레인지, 팟, 유효 스택 및 히어로 포지션을 제출해야 하는 맞춤 플롭, 턴 또는 리버 스팟에는 이 워크플로를 사용하세요. 이는 제출된 하나의 풀이 핸들에 대한 수명 주기이며, 모든 포커 형식이나 결과 품질에 관한 주장이 아닙니다.
사용하지 말아야 할 때
실제 현금 게임의 실시간 보조(RTA)에 사용하지 마세요. Pokerai API는 훈련, 코칭, 핸드 검토, 학습 및 연구용입니다. computing, expired, no_nodes 또는 노드 error 응답을 완료된 전략으로 취급하지 마세요.
최소 검증 가능 요청
curl -s https://pokerai.bet/v1/gto/solver -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"board":"2c2h2s","oop_range":"AA,KK","ip_range":"QQ,JJ","pot":6,"effective_stack":100,"hero":"OOP"}'응답의 solve 핸들을 저장하세요. 응답은 computing 또는 queryable을 보고할 수 있으며, 새 트리거에만 solve_quota가 포함됩니다.
트리를 폴링한 다음 완료된 노드를 읽으세요
curl -s https://pokerai.bet/v1/gto/solver/tree -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"solve":"<풀이 핸들>"}'curl -s https://pokerai.bet/v1/gto/solver/node -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"node":"<쿼리 가능한 트리의 노드 토큰>"}'히어로 노드의 경우 문서화된 성공 형식에는 strategy가 있습니다. 빌런 노드이거나 hole_cards가 생략된 경우, 문서화된 응답은 actions 및 range_strategy를 제공할 수 있습니다. 현재 OpenAPI 계약에 문서화된 필드만 사용하세요.
상태 및 오류 처리
| 신호 | 의미 | 수행할 작업 |
|---|---|---|
computing | 풀이 또는 노드가 아직 처리 중입니다. | 트리를 다시 폴링하세요. 완료된 것처럼 전략을 요청하지 마세요. |
queryable | 트리를 검사할 준비가 되었습니다. | 반환된 노드 토큰을 선택하고 /v1/gto/solver/node를 호출하세요. |
no_nodes | 조회한 라운드 또는 런아웃에 결정 노드가 없습니다. | 해당 라운드 또는 런아웃의 폴링을 중지하세요. |
expired | 풀이가 회수되었거나 대체되었습니다. | 새 풀이를 예약하세요. 이전 핸들은 조회할 수 없습니다. |
error | 노드가 선택적으로 message와 함께 전략 오류를 보고합니다. | 실패한 노드로 처리하세요. 전략으로 제시하지 마세요. |
HTTP 429에서 status: busy | 모든 솔버 호스트가 사용 중입니다. | 백오프를 적용해 재시도하세요. 이는 할당량 청구가 아닙니다. |
HTTP 503 | 트리 또는 노드 업스트림을 사용할 수 없습니다. | 이를 일시적인 것으로 처리하고 적절한 경우 백오프를 적용해 재시도하세요. |
할당량 및 관련 리소스
새 풀이가 실시간 풀이 카운터를 소모하며, 캐시됨 상태의 풀이 재사용과 솔버 트리/노드 읽기는 무료입니다. 현재 월간 카운터는 할당량 주제를 참조하세요.
- 문서 허브 — API 개념 및 인증.
- 할당량 — 무료 한도 및
busy처리. - API 참조 — 현재 솔버 작업 스키마.
- OpenAPI 스냅샷 — 기계가 읽을 수 있는 솔버 수명 주기 계약.
- GTO 솔버 API 가이드 — 관련 구현 가이드.
- Python SDK, TypeScript / JavaScript SDK, 및 MCP 서버 — 공식 패키지 진입점.
Real-time assistance at real-money tables is prohibited.