Skip to Content

Familia Grok

Los modelos Grok de xAI, que incluyen los modelos de razonamiento Grok 4.7, 4.6, 4.5 y 4.3, y los modelos sin razonamiento Grok 4.1 Fast y 4.20. Se invocan a través de la API compatible con OpenAI.

Tareas habituales

Modelos

La lista completa de modelos y los precios actualizados están en la página de modelos . El prefijo de los ID de modelo es x-ai/ y puede omitirse.

ID de modelo habituales (cópielos exactamente)
Grok 4.7x-ai/grok-4.7Modelo de razonamiento, contexto de 500K
Grok 4.1 Fastx-ai/grok-4.1-fastSin razonamiento, contexto de 2M, admite imágenes
TipoModeloDescripción
Modelo de razonamientoGrok 4.7, 4.6, 4.5Siempre razonan y tardan más; contexto de 500K, solo texto
Modelo de razonamientoGrok 4.3Contexto de 1M, admite entrada de imágenes
Modelo sin razonamientoGrok 4.1 Fast, 4.20Respuesta rápida; contexto de 2M, admiten entrada de imágenes

Endpoints compatibles

EndpointModelos compatibles
Chat Completions /v1/chat/completionsTodos
Responses /v1/responsesGrok 4.3, 4.20, 4.1 Fast
API nativa de AnthropicSolo Grok 4.3; los demás devuelven protocol_not_supported

Los modelos Grok los ofrece xAI oficialmente (grok); algunos modelos también están disponibles a través del proveedor Azure AI Foundry.

Ejemplos de llamada

grok_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="x-ai/grok-4.7", reasoning_effort="low", messages=[{"role": "user", "content": "Explica en una frase qué es la idempotencia."}], ) print(resp.choices[0].message.content) print("Tokens de razonamiento:", resp.usage.completion_tokens_details.reasoning_tokens)

Razonamiento

ClaveGrok 4.7, 4.6 y 4.5 siempre razonan, y los problemas complejos pueden tardar varios minutos. Use reasoning_effort: low para reducir el razonamiento, o cambie al modelo sin razonamiento Grok 4.1 Fast.
ModeloRazonamientoreasoning_effort
Grok 4.7, 4.6, 4.5Siempre razonanlow reduce notablemente el razonamiento
Grok 4.3Siempre razona, sin devolver el contenido del razonamientoSe puede enviar
Grok 4.1 Fast, 4.20Sin razonamientoEn Grok 4.1 Fast, enviarlo devuelve 400

Medición con el mismo problema matemático: Grok 4.7 con la configuración predeterminada razonó unos 15 000 tokens y tardó unos 4 minutos; con reasoning_effort: "low", unos 4200 tokens y alrededor de 1 minuto. Los tokens de razonamiento se facturan al precio de salida, y su cantidad figura en usage.completion_tokens_details.reasoning_tokens; el contenido del razonamiento llega en delta.reasoning_content de la respuesta en streaming.

Otras funciones

  • Entrada de imágenes: la admiten Grok 4.3, 4.20 y 4.1 Fast, mediante bloques de contenido image_url estándar; el formato está en Comprensión visual.
  • Salida estructurada y llamada a herramientas: response_format admite json_schema; la llamada a herramientas usa el parámetro estándar tools.
  • Caché: los prefijos de petición repetidos se almacenan en caché automáticamente; la cantidad de aciertos figura en usage.prompt_tokens_details.cached_tokens.

Errores habituales

HTTP · typeMensaje de error originalCausaSolución
400 invalid_request_errorContiene This model does not support y reasoningSe envió reasoning_effort al modelo sin razonamiento Grok 4.1 FastElimine ese parámetro
400 protocol_not_supportedModel 'x-ai/grok-4.7' does not support the 'anthropic' protocol on this platform.El modelo no admite la API de AnthropicUse la API compatible con OpenAI
400 endpoint_not_supportedModel 'x-ai/grok-4.7' does not support the /v1/responses endpoint on this platform.El modelo no admite el endpoint ResponsesUse /v1/chat/completions
404 model_not_foundModel 'xai/grok-4.7' not foundEl prefijo se escribió como xai/El prefijo es x-ai/
Tiempo de espera agotado—El razonamiento tarda demasiadoEnvíe reasoning_effort: "low", use salida en streaming o configure el tiempo de espera del cliente en 600 segundos o más

Otros errores generales en Gestión de errores.

Documentación oficial

Preguntas frecuentes

¿Cómo se escribe el ID de modelo de Grok?

La forma estándar es x-ai/grok-4.7; también puede omitir el prefijo y escribir grok-4.7. Si escribe xai/grok-4.7, se devuelve 404.

¿Por qué Grok 4.7 es tan lento?

Grok 4.7, 4.6 y 4.5 siempre razonan; en problemas complejos pueden razonar más de diez mil tokens y tardar varios minutos. Enviar reasoning_effort: "low" lo acorta notablemente; también puede usar Grok 4.1 Fast, que no razona.

¿Se puede desactivar el razonamiento en Grok?

En Grok 4.7, 4.6, 4.5 y 4.3 no se puede desactivar; solo puede reducirse con reasoning_effort. Si necesita respuestas rápidas, use Grok 4.1 Fast.

¿Se puede usar Grok con Claude Code?

Solo Grok 4.3 admite la API de Anthropic; las llamadas con los demás modelos Grok devuelven protocol_not_supported.

¿Qué longitud de contexto admite Grok?

Grok 4.1 Fast y 4.20 admiten 2M tokens, Grok 4.3 1M, y Grok 4.7, 4.6 y 4.5 500K.

Última actualización: