Saltar al contenido principal

​
Introducción

Grok es un servicio de chat AI proporcionado por Ace Data Cloud, parte de la serie de grandes modelos de lenguaje xAI Grok. A través de la API unificada de Ace Data Cloud, puedes integrar rápidamente Grok con Python para lograr funciones como diálogo multironda, indicaciones del sistema, salida en streaming, modo de salida JSON, comprensión visual, entre otras.

​
Requisitos previos

  • Tener una cuenta en Ace Data Cloud y obtener un API Token
  • Entorno Python 3.7 o superior
  • Instalar la librería requests: pip install requests

​
Uso básico

El endpoint principal para llamar a la API de Grok es: 
POST https://api.acedata.cloud/grok/chat/completions
Este ejemplo utiliza el modelo grok-3.
Modelos disponibles incluyen: grok-4, grok-4-1-fast, grok-3, grok-3-mini, grok-2-vision. Ejemplo completo de código Python: 
import requests

url = "https://api.acedata.cloud/grok/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "grok-3",
    "messages": [
        {
            "role": "user",
            "content": "你好，请介绍一下你自己"
        }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Por favor, reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de la respuesta

Tras una llamada exitosa, la API devuelve datos en formato JSON. Se recomienda verificar el código de estado HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Llamada exitosa:", result)
else:
    print(f"Llamada fallida, código de estado: {response.status_code}")
    print(response.text)

​
Uso avanzado

Para APIs de chat, se soporta salida en streaming para obtener respuestas en tiempo real: 
import requests

data['stream'] = True
response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode())

​
Manejo de errores

Códigos de error comunes:
CódigoDescripción
401Autenticación fallida, verifica el API Token
403Saldo insuficiente o acceso denegado
429Límite de frecuencia de solicitudes excedido
500Error interno del servidor

​
Próximos pasos