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

El SDK de OpenAI para Grok

Lección 6 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Reutiliza lo que ya sabes sobre OpenAI
  2. Instalación
  3. Configura el cliente para xAI
  4. Envía un mensaje
  5. Migra un proyecto existente de OpenAI
  6. Diferencias que debes conocer
  7. Cuándo elegir este enfoque
  8. Puntos clave

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; logprobs y top_logprobs (ignorados a partir de grok-4.20) y logit_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.6 y grok-4.5 siguen disponibles)
  • grok-4.20-0309-reasoning: razonamiento avanzado
  • grok-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_penalty y presence_penalty no son compatibles con los modelos de razonamiento
  • El parámetro stop no está disponible en los modelos de razonamiento
  • logprobs y top_logprobs son ignorados silenciosamente por grok-4.20 y modelos posteriores, y logit_bias no 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 constructor OpenAI()
  • Sustituye la clave de API y el nombre del modelo
  • Las variables OPENAI_BASE_URL y OPENAI_API_KEY permiten una migración sin tocar el código
  • Algunos parámetros (penalizaciones, stop) no son compatibles con los modelos de razonamiento