Wywołanie API za pomocą cURL
Na tej stronie
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
jqdo formatowania i filtrowania odpowiedzi JSON - Przechowuj złożone żądania w osobnych plikach JSON