Grok

Use el ID de modelo exacto que devuelve GET /v1/models; no hay alias ni nombres abreviados registrados.

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "messages": [{
      "role": "user",
      "content": "Resuma los riesgos de este trimestre en cinco puntos."
    }]
  }'

Modelos de chat y razonamiento

Tanto POST /v1/chat/completions como POST /v1/responses están disponibles para cualquier cliente del SDK de OpenAI. Codex CLI no puede usar Grok directamente: envía una herramienta de tipo namespace que el servicio del modelo rechaza con 422 antes de generar nada. En /v1/responses, previous_response_id se elimina y store se fuerza a false: envíe el input completo en cada turno.

422 Failed to deserialize the JSON body into the target type: tools[<n>].type: unknown variant `namespace`

Los modelos de chat e imagen los sirve el grupo Grok gama completa; el video lo sirve Grok Video. Una clave solo llega al modelo de video si también incluye Grok Video; una misma clave puede incluir ambos grupos. Compruebe GET /v1/models con la clave que vaya a usar.

Parámetros de la solicitud

Se aplica a los dos endpoints. La pasarela solo rechaza messages vacío en Chat Completions y no fija límites a los parámetros siguientes; los marcados como «oficial» provienen de la guía de razonamiento de xAI y su referencia de API.

xAI solo ofrece reasoning_effort en dos modelos:

• grok-4.6: low / medium / high / xhigh.
• grok-4.5: low / medium / high.
• grok-4.20-multi-agent-0309 usa reasoning.effort (reasoning_effort en Chat Completions), que fija cuántos agentes colaboran.

presence_penalty, frequency_penalty y stop no son compatibles (oficial); los modelos de razonamiento los rechazan con error. En grok-4.20 y posteriores tampoco lo son logprobs ni top_logprobs, y no se devuelven probabilidades logarítmicas de tokens: omítalos.

Todos los campos están en la referencia de API · Chat Completions; elija la familia Grok.

Facturación y uso

Solicitudes de contexto largo

Una solicitud cuya entrada supera los 200.000 tokens se trata como solicitud de contexto largo.

• El umbral cuenta la entrada no almacenada en caché más la entrada en caché. Los tokens de salida no cuentan.
• Una solicitud que se queda exactamente en 200.000 tokens no lo cruza; hace falta un token más.
• Las solicitudes afectadas se marcan como long_context en la página Consumo de la consola, para poder distinguirlas.

Tokens de razonamiento

Grok es una familia de razonamiento, y los dos endpoints informan el razonamiento de forma distinta. Esto importa al leer usage de forma programática.

Chat Completions informa el razonamiento aparte en completion_tokens_details.reasoning_tokens. HopBase transmite el cuerpo de la respuesta de xAI sin cambios, así que una sola respuesta puede informar completion_tokens: 1 con reasoning_tokens: 158.

Sume ambos para obtener la longitud real de salida; en /v1/responses ya está incluido, no lo sume dos veces.

Herramientas del servidor

Grok puede llamar a herramientas integradas del servidor durante una solicitud: búsqueda web, búsqueda en X, intérprete de código, búsqueda de documentos y búsqueda de archivos. Las llamadas MCP van a su propio servicio remoto.

El número de llamadas a herramientas que hizo una solicitud aparece en la página Consumo de la consola, desglosado por tipo. Consulte sus tarifas efectivas en la Plaza de modelos con la sesión iniciada.

Modelos de imagen

Los modelos de imagen de Grok grok-imagine-image, grok-imagine-image-2.0 y grok-imagine-image-quality usan la API de imágenes estándar de OpenAI y solo admiten llamadas síncronas. Use POST /v1/images/generations para texto a imagen y POST /v1/images/edits para imagen a imagen.

La forma la fija aspect_ratio y el nivel de píxeles resolution; no existe size. Los parámetros completos, los tamaños de salida medidos y la base de facturación están en Imagen y video de Grok Imagine.

El video de Grok (grok-imagine-video-1.5) pertenece al grupo Grok Video y usa la API de tareas asíncronas; se explica en la misma página.

Próximos pasos

• Imagen y video de Grok Imagine
• Codex CLI: conexión directa por Responses
• Códigos de error y reintentos
• Concurrencia, tiempos de espera y facturación