Ir al contenido principal
Español— Elegir un idioma
Menú

El SDK de Python de xAI

Lección 5 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. El SDK oficial de Python de xAI
  2. Instalación
  3. Inicialización del cliente
  4. Envío de una solicitud
  5. Ventajas del SDK nativo
  6. Cuándo elegir este SDK
  7. Puntos clave

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.

pip
Instalación estándar
Cliente
Clase principal
Automático
Detección de la clave de API
Nativo
Soporte completo de xAI

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 recomienda grok-4.7
  • messages: los mensajes iniciales de la conversación, construidos con system(), user() y assistant() desde xai_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, con top_p en 0,95
  • max_tokens: el número máximo de tokens generados
  • reasoning_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-sdk en un entorno virtual
  • La clase Client es el punto de entrada, con detección automática de XAI_API_KEY
  • client.chat.create() crea una conversación; chat.append(user(...)) añade un mensaje, y chat.sample() devuelve la respuesta, que se lee desde response.content
  • Prefiere este SDK para nuevos proyectos que tengan como objetivo únicamente la API de Grok