Saltar para o conteúdo principal

​
Introdução

Grok é um serviço de chat AI fornecido pela Ace Data Cloud, parte da série de grandes modelos de linguagem xAI Grok. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Grok com Python para realizar diálogos multi-turno, prompts de sistema, saída em streaming, modo de saída JSON, compreensão visual e outras funcionalidades.

​
Pré-requisitos

  • Possuir uma conta na Ace Data Cloud e obter o API Token
  • Ambiente Python 3.7 ou superior
  • Instalar a biblioteca requests: pip install requests

​
Uso Básico

O endpoint principal para chamar a API Grok é: 
POST https://api.acedata.cloud/grok/chat/completions
Este exemplo utiliza o modelo grok-3.
Modelos disponíveis incluem: grok-4, grok-4-1-fast, grok-3, grok-3-mini, grok-2-vision. Exemplo 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)
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento da Resposta

Após a chamada bem-sucedida, a API retorna dados em formato JSON. Recomenda-se verificar o código de status HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chamada bem-sucedida:", result)
else:
    print(f"Chamada falhou, código de status: {response.status_code}")
    print(response.text)

​
Uso Avançado

Para APIs de chat, é suportada saída em streaming para obter respostas em tempo 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())

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Próximos Passos