Klicanje API-ja s cURL
Na tej strani
Univerzalno orodje za testiranje API-jev
cURL je orodje ukazne vrstice, na voljo na vsakem operacijskem sistemu. Omogoča ti pošiljanje zahtev HTTP brez namestitve SDK-ja ali pisanja programa. Je idealno orodje za hitro testiranje končne točke, odpravljanje napak v zahtevi ali avtomatizacijo klicev v lupinskem skriptu.
Tvoja prva zahteva s cURL
Tako pošlješ zahtevo API-ju Grok s 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."}
]
}'
Razčlenitev ukaza
curl https://api.x.ai/v1/chat/completions: pošlje zahtevo POST (kar implicira-d) na končno točko-H "Authorization: Bearer $XAI_API_KEY": doda glavo za avtentikacijo s tvojim ključem-H "Content-Type: application/json": pove, da je telo v formatu JSON-d '{...}': telo zahteve v formatu JSON
Uporaba končne točke /v1/responses
Sodobna končna točka /v1/responses ponuja jedrnatejšo sintakso:
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."
}'
Upoštevaj, da input nadomesti messages za preproste zahteve. Namesto polja sporočil lahko neposredno podaš niz.
Koristne možnosti cURL
Oblikovanje izhoda JSON
Surov odgovor je težko brati. Za oblikovanje uporabi jq:
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 .
Možnost -s (tiho) skrije vrstico napredka cURL.
Izvleči samo odgovor
Če želiš dobiti besedilo odgovora brez metapodatkov:
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'
Ogled glav odgovora
Za odpravljanje napak pri omejitvah hitrosti ali drugih napakah dodaj -i za prikaz glav 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"}'
Branje telesa iz datoteke
Za kompleksne zahteve shrani JSON v datoteko:
# 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
}
Nato se nanjo sklicuj z @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Odpravljanje pogostih napak
- 401 Unauthorized: neveljaven ali manjkajoč ključ API. Preveri z
echo $XAI_API_KEY - 400 Bad Request: napačno oblikovan JSON. Preveri svoj JSON z
jq . < request.json - 429 Too Many Requests: dosegel si omejitev hitrosti. Počakaj nekaj sekund
- 404 Not Found: preveri URL in pot končne točke
Ključne ugotovitve
- cURL je popoln za testiranje in odpravljanje napak brez pisanja kode
- Avtenticiraj se z
-H "Authorization: Bearer $XAI_API_KEY" - Uporabi
jqza oblikovanje in filtriranje odgovorov JSON - Kompleksne zahteve shrani v ločene datoteke JSON