Przejdź do głównej treści
Polski— Wybierz język
Menu

Wywołanie API za pomocą cURL

Lekcja 8 z 14 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Uniwersalne narzędzie do testowania API
  2. Twoje pierwsze żądanie cURL
  3. Użycie punktu końcowego /v1/responses
  4. Przydatne opcje cURL
  5. Odczyt treści z pliku
  6. Debugowanie typowych błędów
  7. Kluczowe wnioski

Uniwersalne narzędzie do testowania API

cURL to narzędzie wiersza poleceń dostępne w każdym systemie operacyjnym. Pozwala wysyłać żądania HTTP bez konieczności instalowania SDK czy pisania programu. To idealne rozwiązanie do szybkiego testowania punktów końcowych, debugowania żądań lub automatyzowania wywołań w skryptach powłoki.

Twoje pierwsze żądanie cURL

Oto jak wysłać żądanie do API Grok za pomocą cURL:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {"role": "user", "content": "Hello, introduce yourself in one sentence."}
    ]
  }'

Analiza polecenia

  • curl https://api.x.ai/v1/chat/completions: wysyła żądanie POST (wynikające z użycia -d) do punktu końcowego
  • -H "Authorization: Bearer $XAI_API_KEY": dodaje nagłówek uwierzytelniający z Twoim kluczem
  • -H "Content-Type: application/json": informuje, że treść żądania jest w formacie JSON
  • -d '{...}': treść żądania w formacie JSON

Użycie punktu końcowego /v1/responses

Nowoczesny punkt końcowy /v1/responses oferuje bardziej zwięzłą składnię:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Explain machine learning to me in simple terms."
  }'

Zauważ, że w przypadku prostych żądań parametr input zastępuje messages. Możesz przekazać ciąg znaków bezpośrednio, zamiast tablicy wiadomości.

Przydatne opcje cURL

Formatowanie wyjścia JSON

Surowa odpowiedź jest trudna do odczytania. Użyj jq, aby ją sformatować:

curl -s https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Hello"}' | jq .

Opcja -s (silent) ukrywa pasek postępu cURL.

Wyodrębnienie samej odpowiedzi

Aby uzyskać tylko tekst odpowiedzi bez metadanych:

curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }' | jq -r '.choices[0].message.content'

Wyświetlenie nagłówków odpowiedzi

Aby zdiagnozować limity przepustowości lub błędy, dodaj -i, aby wyświetlić nagłówki HTTP:

curl -i https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Test"}'

Odczyt treści z pliku

W przypadku złożonych żądań przechowuj JSON w pliku:

# request.json
{
  "model": "grok-4.5",
  "messages": [
    {"role": "system", "content": "You are a translator."},
    {"role": "user", "content": "Translate into French: Hello world"}
  ],
  "temperature": 0.3
}

Następnie odwołaj się do niego za pomocą @:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Debugowanie typowych błędów

  • 401 Unauthorized: nieprawidłowy lub brakujący klucz API. Sprawdź wynik polecenia echo $XAI_API_KEY
  • 400 Bad Request: błędnie sformatowany JSON. Zweryfikuj swój JSON poleceniem jq . < request.json
  • 429 Too Many Requests: przekroczyłeś limit żądań. Odczekaj kilka sekund
  • 404 Not Found: sprawdź adres URL i ścieżkę punktu końcowego

Kluczowe wnioski

  • cURL doskonale nadaje się do testowania i debugowania bez pisania kodu
  • Uwierzytelniaj się, używając -H "Authorization: Bearer $XAI_API_KEY"
  • Wykorzystaj jq do formatowania i filtrowania odpowiedzi JSON
  • Przechowuj złożone żądania w osobnych plikach JSON