Grok es la familia de modelos de xAI. Su API sigue un formato compatible con OpenAI, así que los desarrolladores pueden llamarla con el mismo SDK de OpenAI que ya utilizan para otros modelos. En China continental, los problemas prácticos suelen ser el acceso, el pago y el control de las cuotas de uso.
Esta guía explica cómo obtener una clave de API de Grok, cómo hacer la primera llamada y cómo conectarse a través de una puerta de enlace cuando el acceso directo no resulta práctico.
Nota: Grok y xAI son marcas registradas de sus respectivos propietarios. Este artículo refleja las versiones habituales en octubre de 2026. Las interfaces y los precios están sujetos al proveedor oficial o a la página de precios de este sitio.
1. Qué puede hacer la API de Grok
Los modelos de Grok cubren un amplio conjunto de tareas de desarrollo cotidianas:
- Respuestas a preguntas generales, redacción y resumen.
- Generación y explicación de código.
- Llamada a herramientas y flujos de trabajo con agentes.
- Análisis de documentos con contexto largo.
- Pruebas comparativas con otros modelos.
Los nombres de modelo y las longitudes de contexto disponibles dependen de tu proveedor. Consulta el precio de los modelos para ver la lista actual antes de fijar un nombre de modelo en el código.
2. Dos formas de obtener una clave
xAI oficial
Crea una clave de API en la consola de xAI y añade un método de pago. Esta vía encaja en equipos que pueden acceder a xAI de forma fiable y ya disponen de un método de pago internacional. Antes de empezar, confirma los requisitos de la cuenta, la moneda de facturación y si tu caso de uso está permitido según los términos del servicio.
ZSQH AI Gateway
- Abre ZSQH AI Gateway y regístrate.
- Crea una clave de API y define un límite de gasto.
- Recarga tu saldo.
- Llama a la API con el SDK de OpenAI o con curl.
Esta vía encaja en equipos cuyo acceso desde China continental no es fiable, o que quieren una sola factura y la posibilidad de cambiar de modelo sin gestionar varias cuentas.
3. URL base
El endpoint oficial de xAI suele ser:
https://api.x.ai/v1
El endpoint compatible con OpenAI de ZSQH es:
https://ai.zhongshangqihang.com/v1
No mezcles las dos direcciones. Una clave emitida por un proveedor no funcionará contra la URL base de otro. Mantén la clave y la URL base emparejadas.
4. Prueba con curl
La forma más rápida de confirmar que tu clave, la URL base y el nombre del modelo son correctos es una sola petición curl:
export GROK_API_KEY="sk-tu-clave"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $GROK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4",
"messages": [{"role": "user", "content": "Responde solo OK"}]
}'
Una respuesta correcta devuelve un objeto Chat Completions normal. Los nombres de modelo están sujetos al precio de los modelos.
5. Ejemplo en Python
Si ya usas el SDK de Python de OpenAI, los únicos cambios son la clave de API y la URL base:
from openai import OpenAI
client = OpenAI(
api_key="sk-tu-clave",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="grok-4",
messages=[{"role": "user", "content": "Explica qué es una puerta de enlace API en tres frases"}],
)
print(resp.choices[0].message.content)
Guarda la configuración del cliente en una variable de entorno o en un almacén de secretos del servidor. No incluyas la clave en una aplicación que se ejecute en el navegador.
6. Errores comunes
| Error | Causa | Solución |
|---|---|---|
| 401 | La clave y la URL no coinciden | Revisa la clave y la URL base |
| 404 | Ruta incorrecta | Usa solo hasta /v1 |
| model not found | Nombre de modelo incorrecto | Copia el nombre de la página de precios |
| 429 | Límite de peticiones | Reduce la concurrencia y reintenta con retroceso exponencial |
| insufficient quota | Saldo bajo | Recarga y revisa el límite de la clave |
La mayoría de los fallos de configuración se deben a una de estas cinco causas. Revísalas en orden antes de tocar el código de la aplicación.
7. Coste y selección de modelo
El precio unitario de Grok, la ventana de contexto y el comportamiento de llamada a herramientas afectan a la factura final. Una estimación práctica sería así:
- Mide los tokens de entrada y salida medios al día a partir de registros reales.
- Consulta el precio actual del modelo que piensas usar.
- Añade el coste de los reintentos y de las peticiones con contexto largo.
- Compara con otros modelos y asigna cada tarea al modelo más económico que cumpla el nivel de calidad.
No mires solo el precio unitario. Los contextos largos y los tokens de salida suelen ser la mayor parte de la factura, sobre todo en cargas de trabajo con agentes que reenvían el historial de conversación en cada turno.
Preguntas frecuentes
¿La API de Grok es compatible con OpenAI?
Por lo general admite el formato Chat Completions, así que el SDK de OpenAI funciona para la mayoría de las llamadas. El soporte de parámetros concretos depende de la documentación oficial o de la documentación de la puerta de enlace; prueba cualquier función avanzada antes de depender de ella.
¿Cómo puedo llamarla de forma fiable desde China continental?
Usa una conexión directa oficial si tu red lo permite, o una puerta de enlace accesible desde China continental. En ambos casos, empieza con una clave pequeña y confirma la latencia y la tasa de errores antes de trasladar tráfico de producción.
¿Puede una sola clave llamar a varios modelos?
Con una puerta de enlace, sí. Especificas el modelo en los parámetros de la petición, así que la misma clave puede acceder a distintos modelos siempre que tu cuenta tenga permiso para usarlos.
Siguientes pasos
Si necesitas acceso desde el país o un único punto de entrada para varios modelos, regístrate en ZSQH AI Gateway y prueba con una clave pequeña. Los modelos y los precios están sujetos al precio de los modelos.
Lecturas relacionadas:
