Sejjaħ l-API b'cURL
F'din il-paġna
L-għodda universali biex tittestja l-APIs
cURL huwa għodda tal-linja tal-kmand disponibbli fuq kull sistema operattiva. Jippermettilek tibgħat talbiet HTTP mingħajr ma tinstalla SDK jew tikteb programm. Hija l-għodda ideali biex tittestja endpoint malajr, tiddibbuggja talba, jew tawtomatizza sejħiet fi skritt tal-qoxra (shell script).
L-ewwel talba cURL tiegħek
Hekk kif tibgħat talba lill-API ta’ Grok b’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."}
]
}'
Analiżi tal-kmand
curl https://api.x.ai/v1/chat/completions: jibgħat talba POST (implikata minn-d) lejn l-endpoint-H "Authorization: Bearer $XAI_API_KEY": jżid l-intestazzjoni tal-awtentikazzjoni bil-muftaħ tiegħek-H "Content-Type: application/json": jindika li l-korp huwa JSON-d '{...}': il-korp tat-talba f’format JSON
Uża l-endpoint /v1/responses
L-endpoint modern /v1/responses joffri sintassi iktar konċiża:
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."
}'
Innota li input tissostitwixxi messages għal talbiet sempliċi. Tista’ tgħaddi stringa direttament minflok array ta’ messaġġi.
Għażliet utli ta’ cURL
Ifformatta l-output JSON
Ir-risposta raw hija diffiċli biex taqraha. Uża jq biex tiffurmattja:
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 .
L-għażla -s (silent) taħbi l-linja tal-progress ta’ cURL.
Estrai biss it-tweġiba
Biex tikseb it-test tat-tweġiba mingħajr il-metadejta:
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'
Ara l-intestazzjonijiet tar-risposta
Biex tiddibbuggja limiti ta’ rati jew żbalji, żid -i biex turi l-intestazzjonijiet 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"}'
Aqra l-korp minn fajl
Għal talbiet kumplessi, aħżen il-JSON f’fajl:
# 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
}
Imbagħad irreferenzjah b’@:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Iddibbuggja żbalji komuni
- 401 Unauthorized: muftaħ API invalidu jew nieqes. Iċċekkja
echo $XAI_API_KEY - 400 Bad Request: JSON malformat. Ivvalida l-JSON tiegħek b’
jq . < request.json - 429 Too Many Requests: laqqt il-limitu tar-rata. Stenna ftit sekondi
- 404 Not Found: iċċekkja l-URL u l-mogħdija tal-endpoint
Punti Ewlenin
- cURL huwa perfett biex tittestja u tiddibbuggja mingħajr ma tikteb kodiċi
- Awtentika b’
-H "Authorization: Bearer $XAI_API_KEY" - Uża
jqbiex tifformatta u tiffiltra risposti JSON - Aħżen talbiet kumplessi f’fajls JSON separati