Kviesti API naudojant cURL
Šiame puslapyje
Universali priemonė API testavimui
cURL yra komandinės eilutės įrankis, prieinamas visose operacinėse sistemose. Jis leidžia siųsti HTTP užklausas neinstaliuojant SDK ir nerašant programos. Tai idealus įrankis greitai patikrinti galinį tašką (endpoint), derinti užklausas arba automatizuoti kvietimus apvalkalo (shell) scenarijuose.
Tavo pirmoji cURL užklausa
Štai kaip siųsti užklausą į Grok API naudojant 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."}
]
}'
Komandos analizė
curl https://api.x.ai/v1/chat/completions: siunčia POST užklausą (numanoma dėl-d) į galinį tašką-H "Authorization: Bearer $XAI_API_KEY": prideda autentifikavimo antraštę su tavo raktu-H "Content-Type: application/json": nurodo, kad kūnas yra JSON formato-d '{...}': užklausos kūnas JSON formatu
Naudok /v1/responses galinį tašką
Šiuolaikinis /v1/responses galinis taškas siūlo glaustesnę sintaksę:
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."
}'
Atkreipk dėmesį, kad paprastoms užklausoms input pakeičia messages. Vietoj žinučių masyvo gali perduoti tiesioginę eilutę.
Naudingos cURL parinktys
Formatuok JSON išvestį
Neapdorotą atsakymą sunku skaityti. Naudok jq, kad jį suformatuotum:
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 .
Parinktis -s (tylus) paslepia cURL eigos juostą.
Ištrauk tik atsakymą
Norint gauti atsakymo tekstą be metaduomenų:
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'
Peržiūrėk atsakymo antraštes
Norint derinti spartos ribas ar klaidas, pridėk -i, kad būtų rodomos HTTP antraštės:
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"}'
Skaityk kūną iš failo
Sudėtingoms užklausoms JSON duomenis išsaugok faile:
# 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
}
Tada nurodyk jį naudodamas @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Derink įprastas klaidas
- 401 Unauthorized: neteisingas arba trūkstamas API raktas. Patikrink naudodamas
echo $XAI_API_KEY - 400 Bad Request: neteisingai suformuotas JSON. Patikrink savo JSON naudodamas
jq . < request.json - 429 Too Many Requests: viršijai spartos ribą. Palauk kelias sekundes
- 404 Not Found: patikrink URL ir galinio taško kelią
Svarbiausi punktai
- cURL puikiai tinka testavimui ir derinimui nerašant kodo
- Autentifikuokis naudodamas
-H "Authorization: Bearer $XAI_API_KEY" - Naudok
jqJSON atsakymams formatuoti ir filtruoti - Sudėtingas užklausas saugok atskiruose JSON failuose