¿Cómo hago mi primera solicitud con el SDK de Python de Pokerai?

Datos rápidos

Instala y autentícate

Instala el paquete indicado en los datos de producto aprobados y luego exporta una clave de API localmente. No incluyas una clave real en un commit, no la coloques en código del navegador ni la imprimas en los registros.

python -m pip install pokerai-bet
export POKERAI_API_KEY="gto_your_key_here"

Solicitud mínima con el SDK de Python

Este es el patrón oficial de cliente del SDK para la operación pública de estrategia preflop. La estructura de la solicitud, el endpoint y los códigos de estado no exitosos se definen en la instantánea actual de OpenAPI.

import os

from pokerai import AuthenticatedClient
from pokerai.api.lookup import preflop_strategy
from pokerai.models import (
    PreflopRequest,
    PreflopRequestPositions,
    PreflopRequestPreflopActionsItem,
    PreflopRequestPreflopActionsItemAction as Act,
)
from pokerai.models.position import Position

client = AuthenticatedClient(
    base_url="https://pokerai.bet",
    token=os.environ["POKERAI_API_KEY"],
)

req = PreflopRequest(
    hole_cards="AhKh",
    positions=PreflopRequestPositions(hero=Position.MP),
    preflop_actions=[
        PreflopRequestPreflopActionsItem(position=Position.SB, action=Act.SMALL_BLIND, amount=0.5),
        PreflopRequestPreflopActionsItem(position=Position.BB, action=Act.BIG_BLIND, amount=1),
        PreflopRequestPreflopActionsItem(position=Position.UTG, action=Act.RAISE, amount=3),
    ],
)

result = preflop_strategy.sync(client=client, body=req)
print(result)

Interpreta la respuesta

Para una respuesta exitosa, lee situation como el estado preflop derivado e itera strategy. Cada elemento de estrategia tiene una action y una frequency de 0 a 1; los elementos de apuesta o subida también pueden mostrar sizing_pot, amount_bb y allin. Trata el conjunto de frecuencias como una distribución mixta para estudiar o de la que tomar muestras, no como una promesa de beneficio ni como una única jugada recomendada.

La respuesta también puede incluir quota. Registra el uso de la cuenta a partir del resultado devuelto o del panel, en lugar de inferirlo de los contadores del lado del cliente. El contrato público, no una suposición codificada de forma rígida en el SDK, sigue siendo la fuente de la forma actual de la respuesta.

Gestión de errores y cuota

El contrato público para esta operación declara 400, 401 y 429. La llamada sync del SDK generado analiza las respuestas de error documentadas en su modelo de error; usa sync_detailed cuando tu aplicación también necesite el estado HTTP y los encabezados. Corrige la entrada no válida en lugar de volver a intentarlo sin cambios; si faltan credenciales o no son válidas, comprueba la clave Bearer; para 429, comprueba la cuota de la cuenta y la documentación actual sobre cuotas.

Cuándo usarlo

Usa este patrón de SDK en un entrenador del lado del servidor, un producto de coaching, una herramienta de revisión de manos completadas, un flujo de estudio, un proyecto de investigación o una integración de agente de IA con revisión humana. Es una vía concisa cuando quieres modelos tipados de solicitud y respuesta mientras sigues validando con el contrato de la API pública.

Cuándo no usarlo

No uses este ejemplo en código de navegador que exponga una clave de API, un feed de mesa en vivo o un bucle de automatización de acciones. No infieras compatibilidad con endpoints, métodos del SDK, versiones, publicación en el registro ni afirmaciones de rendimiento que estén ausentes de la fuente pública actual y de la instantánea de OpenAPI.

Procedencia y contrato actual

El nombre del paquete, la entrada de instalación, el repositorio y los enlaces a Documentación, Referencia y OpenAPI provienen del archivo locales/product-facts.json de este repositorio. Los nombres de importación y el patrón de llamada anteriores se leyeron de la revisión del código fuente del SDK de Python oficial; esta Guía no afirma deliberadamente una versión del paquete ni un estado de publicación en el registro. Consulta la Referencia de la API actual y la instantánea de OpenAPI antes de actualizar el código de cliente generado.

Sin RTA con dinero real

La API de Pokerai es solo para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. Mantén la salida del SDK fuera de la automatización de mesas en vivo y no presentes frecuencias mixtas como una instrucción de acción en tiempo real.

Operación pública relevante

Comienza con la consulta preflop pre-resuelta documentada; usa la Referencia actual y la instantánea de OpenAPI antes de seleccionar otra operación.

Enlaces de SDK, API y procedencia

• Documentación para desarrolladores — autenticación, cuotas, SDK, MCP y gestión de errores
• Referencia de la API — esquema actual de solicitud y respuesta preflop
• Instantánea de OpenAPI — contrato público en inglés legible por máquina
• Código fuente del SDK de Python — repositorio oficial; consulta la superficie actual de su cliente generado
• Página del paquete de Python — URL oficial del paquete; esta guía no afirma nada sobre el estado de lanzamiento
• SDK de TypeScript / JavaScript — punto de entrada oficial del paquete
• Servidor MCP — punto de entrada oficial del paquete
• Inicio rápido de la API GTO — la solicitud HTTP mínima equivalente y la explicación de estrategia mixta
• llms.txt — punto de entrada conciso para LLM