El SDK de Python de xAI
En esta página
Actualizado el 3 de noviembre de 2026, según las mejores prácticas y la referencia de la API de xAI: temperatura limitada a 1 y recomendada en 0,7. Fuente: Mejores prácticas. El ejemplo de llamada sigue el README del SDK (
chat.append(user(...)),chat.sample(),response.content) y se ejecutó para verificarlo.
El SDK oficial de Python de xAI
El SDK nativo de Python de xAI es la forma más directa de trabajar con la API de Grok. Expone las funciones específicas de la plataforma y recibe actualizaciones en primer lugar cuando se añaden nuevos modelos o puntos de conexión.
Instalación
Instala el SDK con pip en tu entorno de Python:
pip install xai-sdk
Recomendamos usar un entorno virtual para aislar las dependencias de cada proyecto:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inicialización del cliente
La clase Client es el punto de entrada del SDK. Gestiona la autenticación, las conexiones HTTP y la serialización de solicitudes:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Si la variable de entorno XAI_API_KEY está definida, también puedes crear el cliente sin pasar un argumento explícito:
client = Client()
El SDK detecta la variable automáticamente y la utiliza para la autenticación.
Envío de una solicitud
Una vez inicializado el cliente, el SDK funciona mediante conversaciones: client.chat.create() crea la conversación (sin enviar nada), append añade un mensaje construido con user() o system(), y sample() solicita la respuesta al modelo:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.7")
chat.append(user("Explica qué es una API REST en 3 frases."))
response = chat.sample()
print(response.content)
Parámetros comunes
model: el ID del modelo a utilizar (obligatorio); xAI recomiendagrok-4.7messages: los mensajes iniciales de la conversación, construidos consystem(),user()yassistant()desdexai_sdk.chat(los diccionarios simples harán que la llamada falle)temperature: de 0 a 2, limitada a 1 por encima de ese valor; xAI recomienda 0,7, contop_pen 0,95max_tokens: el número máximo de tokens generadosreasoning_effort: la profundidad del razonamiento (none,low,medium,high), que xAI recomienda establecer en cada solicitud
La transmisión (streaming) no se gestiona mediante un parámetro: for response, chunk in chat.stream(): devuelve los fragmentos a medida que llegan en chunk.content. La lección 10 muestra la transmisión con la API REST a través de SSE.
Ventajas del SDK nativo
En comparación con el SDK de OpenAI apuntando a la API de xAI (siguiente lección), el SDK nativo ofrece acceso directo a funciones específicas de xAI: búsqueda en X y web, herramientas del lado del servidor, generación de vídeo y colecciones de documentos. Sus tipos completos de Python potencian el autocompletado de tu editor y xAI lo mantiene al ritmo de la API. También tiene su propia estructura, que debes aceptar: funciona sobre gRPC, sus mensajes se construyen con user() y system(), y sus errores son grpc.RpcError.
Cuándo elegir este SDK
La elección se deriva naturalmente de tu situación. Para un nuevo proyecto construido específicamente sobre la API de Grok, el SDK nativo es el punto de partida obvio: obtienes todo lo anterior sin restricciones de compatibilidad que respetar. Se vuelve esencial tan pronto como planees usar funciones específicas de xAI, como la búsqueda en X o la búsqueda web integrada, que solo funcionan completamente de esta manera. Si, por el contrario, tienes código existente construido sobre el SDK de OpenAI, no reescribas nada por ahora: la siguiente lección muestra cómo adaptarlo cambiando dos líneas.
Puntos clave
- Instala con
pip install xai-sdken un entorno virtual - La clase
Clientes el punto de entrada, con detección automática deXAI_API_KEY client.chat.create()crea una conversación;chat.append(user(...))añade un mensaje, ychat.sample()devuelve la respuesta, que se lee desderesponse.content- Prefiere este SDK para nuevos proyectos que tengan como objetivo únicamente la API de Grok