Przejdź do głównej treści

​
Wprowadzenie

Grok to usługa czatu AI oferowana przez Ace Data Cloud, seria dużych modeli językowych xAI Grok. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywoływać Grok za pomocą cURL, realizując funkcje takie jak wieloetapowa rozmowa, systemowe wskazówki, strumieniowe wyjście, tryb wyjścia JSON, rozumienie wizualne i inne.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko terminalowe z zainstalowanym cURL

​
Podstawowe użycie

Główny endpoint API Grok to: 
POST https://api.acedata.cloud/grok/chat/completions
W tym przykładzie używany jest model grok-3. Dostępne modele to: grok-4, grok-4-1-fast, grok-3, grok-3-mini, grok-2-vision. Pełny przykład polecenia cURL: 
curl -X POST https://api.acedata.cloud/grok/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-3", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}'
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia: 
curl -s -X POST https://api.acedata.cloud/grok/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-3", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}' | jq .

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Wewnętrzny błąd serwera

​
Kolejne kroki