El SDK de OpenAI para Grok
En esta página
Actualizado el 3 de noviembre de 2026, según la página Models de xAI: grok-4.7 (septiembre de 2026) ha sucedido a grok-4.5 como modelo recomendado; el ejemplo, escrito con grok-4.5, también funciona con grok-4.7. Fuentes: Models · Release notes.
Aclarado el 3 de noviembre de 2026, según la referencia de Chat Completions de xAI: la llamada no es estrictamente idéntica a la de OpenAI;
logprobsytop_logprobs(ignorados a partir degrok-4.20) ylogit_bias(no compatible) se suman a las diferencias listadas más abajo. Fuente: xAI, Chat Completions.
Reutiliza lo que ya sabes sobre OpenAI
Si ya trabajas con el SDK de OpenAI en Python, puedes usarlo tal cual para llamar a la API de Grok. Solo tienes que redirigir las peticiones a los servidores de xAI cambiando la URL base. Es el enfoque más rápido si dispones de código existente.
Instalación
Si aún no tienes instalado el SDK de OpenAI en tu proyecto:
pip install openai
Configura el cliente para xAI
La única diferencia respecto al uso habitual de OpenAI es el parámetro base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Eso es todo. A partir de aquí, todos los métodos del SDK de OpenAI funcionan con los modelos de Grok.
Envía un mensaje
La llamada tiene la misma estructura que para GPT, salvo por los parámetros no compatibles (véase más abajo):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "Eres un asistente técnico."},
{"role": "user", "content": "¿Cuál es la diferencia entre REST y GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Modelos disponibles
Solo tienes que sustituir el nombre del modelo de OpenAI por uno de Grok:
grok-4.7: el modelo que recomienda xAI, versátil y con entrada de imagen (grok-4.6ygrok-4.5siguen disponibles)grok-4.20-0309-reasoning: razonamiento avanzadogrok-4.3: respuestas rápidas y económicas (contexto de 1 M)
Migra un proyecto existente de OpenAI
Para adaptar un proyecto existente, tienes dos opciones.
Opción 1: Variables de entorno
Cambia tus variables sin tocar el código:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
El SDK de OpenAI lee estas variables automáticamente. Tu código existente funcionará si también cambias el nombre del modelo y eliminas los parámetros que xAI no admite.
Opción 2: Configuración explícita
Escribe una función de inicialización que alterne entre proveedores:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI por defecto
client = create_client("xai")
Este enfoque te permite cambiar fácilmente entre proveedores durante la migración.
Diferencias que debes conocer
Aunque la API es compatible, algunos comportamientos difieren:
- Los parámetros
frequency_penaltyypresence_penaltyno son compatibles con los modelos de razonamiento - El parámetro
stopno está disponible en los modelos de razonamiento logprobsytop_logprobsson ignorados silenciosamente porgrok-4.20y modelos posteriores, ylogit_biasno es compatible- Los nombres de los modelos son obviamente distintos
- Algunas funciones de xAI (búsqueda en X, búsqueda web) no están disponibles mediante el formato estándar de OpenAI
Cuándo elegir este enfoque
El modo de compatibilidad tiene más sentido cuando tu código existente importa más que las funciones exclusivas. El caso más común es la migración: el código ya escrito para OpenAI pasa a Grok cambiando la URL base y la clave: dos líneas, sin reescritura. La reversibilidad también importa: mientras te mantengas en el formato de OpenAI, cambiar de proveedor sigue siendo cuestión de configuración, algo valioso para comparar modelos o negociar. Luego está el ecosistema: las herramientas de terceros construidas alrededor del SDK de OpenAI, como LangChain y LlamaIndex, funcionan de inmediato, y un equipo que ya conoce el SDK no tiene nada nuevo que aprender. El precio a pagar es el que has visto antes: las funciones específicas de xAI pasan a un segundo plano.
Puntos clave
- Añade
base_url="https://api.x.ai/v1"al constructorOpenAI() - Sustituye la clave de API y el nombre del modelo
- Las variables
OPENAI_BASE_URLyOPENAI_API_KEYpermiten una migración sin tocar el código - Algunos parámetros (penalizaciones, stop) no son compatibles con los modelos de razonamiento