Kutsu API-d cURL-iga
Sellel lehel
Universaalne tööriist API-de testimiseks
cURL on käsurea tööriist, mis on saadaval igas operatsioonisüsteemis. See võimaldab saata HTTP-päringuid ilma SDK-d paigaldamata või programmi kirjutamata. See on ideaalne vahend lõpp-punkti kiireks testimiseks, päringu silumiseks või kõnude automatiseerimiseks shelli-skriptis.
Sinu esimene cURL-päring
Nii saadad päringu Grok API-le cURL-i abil:
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."}
]
}'
Käsu lahtimõtestamine
curl https://api.x.ai/v1/chat/completions: saadab lõpp-punkti POST-päringu (mille annab mõista-d)-H "Authorization: Bearer $XAI_API_KEY": lisab autentimispäise koos sinu võtmega-H "Content-Type: application/json": määrab, et keha on JSON-vormingus-d '{...}': päringu keha JSON-vormingus
Kasuta /v1/responses lõpp-punkti
Moodne /v1/responses lõpp-punkt pakub lühemat süntaksit:
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."
}'
Pane tähele, et lihtsate päringute korral asendab input välja messages. Saad edastada otse sõne asemel sõnumite massiivi.
Kasulikud cURL-i valikud
Vorminda JSON-väljundit
Toores vastus on raskesti loetav. Kasuta jq-d selle vormindamiseks:
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 .
Valik -s (vaikne) peidab cURL-i edenemisriba.
Ekstraheeri ainult vastus
Vastuse teksti saamiseks ilma metaandmeteta:
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'
Vaata vastuse päiseid
Kiirusepiirangute või vigade silumiseks lisa -i, et kuvada HTTP-päised:
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"}'
Loegi keha failist
Keerukate päringute puhul salvesta JSON faili:
# 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
}
Seejärel viita sellele märgiga @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Levinud vigade silumine
- 401 Unauthorized: vigane või puuduv API-võti. Kontrolli käsuga
echo $XAI_API_KEY - 400 Bad Request: valesti vormistatud JSON. Valideeri oma JSON käsuga
jq . < request.json - 429 Too Many Requests: ületasid kiirusepiirangu. Oota mõni sekund
- 404 Not Found: kontrolli URL-i ja lõpp-punkti rada
Peamised punktid
- cURL on suurepärane testimiseks ja silumiseks ilma koodi kirjutamata
- Autendi käsuga
-H "Authorization: Bearer $XAI_API_KEY" - Kasuta
jq-d JSON-vastuste vormindamiseks ja filtreerimiseks - Salvesta keerukad päringud eraldi JSON-failidesse