GTO 솔버 API 풀이를 안전하게 실행하려면 어떻게 해야 하나요?

하나의 실시간 풀이를 짧은 수명 주기로 다루세요. 대기열에 등록하고 트리가 쿼리 가능해질 때까지 폴링한 다음, 해당 트리가 반환한 토큰만 읽으세요.

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

직접 답변: 필수 스팟 필드를 POST /v1/gto/solver로 전송하고, 해당 solve 핸들을 보관한 다음 spot_status가 queryable이 될 때까지 POST /v1/gto/solver/tree를 폴링합니다. 반환된 노드 token을 POST /v1/gto/solver/node로 전달합니다. 이 페이지는 일정 예약, 폴링 및 읽기를 다루며 솔버 선택이나 연구 트리 설계는 다루지 않습니다.

핵심 정보

예약	`POST /v1/gto/solver`에는 `board`, `oop_range`, `ip_range`, `pot`, `effective_stack`, `hero`가 필요합니다.
비동기 신호	일정 `status`는 `computing`, `queryable` 또는 `busy`일 수 있으며, 트리 `spot_status`는 읽기 준비 신호입니다.
읽기 범위	`solve` 핸들은 해당 트리/해제 호출에만 사용하고, 해당 트리가 반환한 `token`은 `/v1/gto/solver/node`의 `node` 입력으로만 사용하세요.
할당량	새로운 풀이가 실행된 경우에만 `solve_quota`가 존재합니다. 트리, 노드 및 선택적 해제 작업은 무료로 문서화되어 있습니다.
결과 범위	읽을 수 있는 노드에는 `strategy` 또는 `actions` 및 `range_strategy`가 포함될 수 있습니다. 읽을 수 없는 상태는 전략이 아닙니다.

1. 예약하고 핸들을 보관하세요

완전하고 자체 완결적인 맞춤 플롭, 턴 또는 리버 스팟을 사용하세요. 보드 길이가 스트리트를 선택합니다. 반환된 solve 핸들을 저장하세요. 이는 이후 트리 및 해제 요청의 식별자입니다.

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"}'

일정 예약 응답은 computing 또는 queryable일 수 있습니다. busy이면 폴링할 풀이 핸들을 사용할 수 없으므로, 완료된 풀이가 아니라 솔버 용량으로 취급하십시오. 공개 계약은 대기 시간이나 가용성 수준을 약속하지 않습니다.

2. 전략을 읽기 전에 트리를 폴링하세요

핸들을 사용하여 POST /v1/gto/solver/tree를 호출하세요. 플롭 풀이의 경우 turn_card는 선택 사항입니다. river_card도 선택 사항이며, 구분이 필요할 때 turn_card와 함께 사용합니다. 다른 풀이를 위해 두 필드 중 어느 것도 임의로 만들지 마세요.

curl -s https://pokerai.bet/v1/gto/solver/tree \
+  -H "Authorization: Bearer $POKERAI_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"solve":"<풀이 핸들>"}'

spot_status가 queryable일 때만 계속 진행하세요. computing은 전략 결과가 아닙니다. no_nodes는 조회한 라운드 또는 런아웃에 대한 종단 상태이므로 폴링을 중지하세요. expired는 핸들을 더 이상 사용할 수 없으며 스팟을 다시 대기열에 등록해야 함을 의미합니다.

3. 트리 토큰으로 노드 읽기

조회 가능한 트리는 node, is_hero, status, token을 포함한 필드를 가진 노드를 반환합니다. 해당 토큰을 node로 전달하세요. 이는 API 키나 재사용 가능한 풀이 핸들을 대체하지 않습니다. 핸들 및 토큰 데이터는 클라이언트 로그에 남기지 마세요.

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를 반환할 수 있습니다. 노드 응답이 node_status를 computing, expired 또는 error로 보고하면 이를 전략으로 제시하지 마세요. error에는 message가 포함될 수 있습니다.

4. 읽을 수 있는 노드만 해석하기

읽을 수 있는 히어로 노드에는 strategy가 포함될 수 있습니다. 빌런 노드 또는 hole_cards가 없는 요청에는 actions 및 range_strategy가 포함될 수 있습니다. 이러한 필드는 반환된 노드를 설명할 뿐, 다른 트리, 스팟 또는 게임 형식에 대한 보장은 아닙니다.

트리가 computing, no_nodes 또는 expired 상태이면 결과를 제시하지 말고 문서에 따라 중지하거나 일정을 다시 잡으세요. 호스팅 API와 데스크톱 솔버 중 어느 것이 더 나은 연구 도구인지 알아보려면 투명한 비교를 참조하세요.

훈련 및 검토에만 사용

이 수명 주기는 오프라인 교육, 코칭, 핸드 리뷰, 학습 및 연구에 사용하세요. 이는 제출된 풀이의 상태 관리를 지원하며, 라이브 테이블 의사결정 제공이나 전략 품질, 지연 시간 또는 성능에 대한 주장을 지원하지 않습니다.

실제 돈이 걸린 테이블에서의 실시간 지원은 금지됩니다. 솔버 예약, 폴링, 노드 전략 및 해제 흐름을 라이브 테이블 자동화와 핸드 진행 중 액션 프롬프트에 포함하지 마세요.

수명 주기 엔드포인트 맵

이 세 작업이면 여기에서 설명한 수명 주기에 충분합니다. 현재 OpenAPI 계약에 문서화된 필드만 사용하세요.

엔드포인트	수명 주기 역할	문서화된 입력 또는 신호
`POST /v1/gto/solver`	예약	필수 스팟 필드. `solve`를 저장하고 `status` 및 선택 사항인 `solve_quota`를 확인하세요.
`POST /v1/gto/solver/tree`	폴링	`solve`를 전송하고 `spot_status: queryable`이 될 때까지 기다린 후 반환된 `token`을 선택합니다.
`POST /v1/gto/solver/node`	읽기	해당 트리 `token`을 `node`로 전송합니다. 선택 사항인 `hole_cards`는 히어로 전략 조회 범위를 좁힙니다.