Izsauc API ar cURL
Šajā lapā
Universālais rīks API testēšanai
cURL ir komandrindas rīks, kas pieejams katrā operētājsistēmā. Tas ļauj nosūtīt HTTP pieprasījumus, neinstalējot SDK un nerakstot programmu. Tas ir ideāls rīks, lai ātri pārbaudītu galapunktu, atkļūdotu pieprasījumu vai automatizētu izsaukumus čaulas skriptā.
Tavs pirmais cURL pieprasījums
Lūk, kā nosūtīt pieprasījumu uz Grok API, izmantojot 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."}
]
}'
Komandas sadalīšana
curl https://api.x.ai/v1/chat/completions: nosūta POST pieprasījumu (netieši norāda-d) uz galapunktu-H "Authorization: Bearer $XAI_API_KEY": pievieno autentifikācijas galveni ar tavu atslēgu-H "Content-Type: application/json": norāda, ka ķermenis ir JSON formātā-d '{...}': pieprasījuma ķermenis JSON formātā
Izmanto /v1/responses galapunktu
Mūsdienu /v1/responses galapunkts piedāvā kodolīgāku sintaksi:
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."
}'
Ņem vērā, ka vienkāršiem pieprasījumiem input aizstāj messages. Vari norādīt virkni tieši, nevis kā ziņojumu masīvu.
Noderīgas cURL opcijas
Formatē JSON izvadi
Neapstrādāta atbilde ir grūti lasāma. Izmanto jq, lai to formatētu:
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 .
Opcija -s (kluss) slēpj cURL progresjoslu.
Izgūst tikai atbildi
Lai iegūtu atbildes tekstu bez metadatiem:
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'
Apskati atbildes galvenes
Lai atkļūdotu ātruma ierobežojumus vai kļūdas, pievieno -i, lai parādītu HTTP galvenes:
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"}'
Lasī ķermeni no faila
Sarežģītiem pieprasījumiem saglabā JSON failā:
# 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
}
Tad norādi to, izmantojot @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Atkļūdo biežākās kļūdas
- 401 Unauthorized: nederīga vai trūkstoša API atslēga. Pārbaudi ar
echo $XAI_API_KEY - 400 Bad Request: nekorekts JSON. Validē savu JSON ar
jq . < request.json - 429 Too Many Requests: esi sasniedzis ātruma ierobežojumu. Uzgaidi dažas sekundes
- 404 Not Found: pārbaudi URL un galapunkta ceļu
Galvenās atziņas
- cURL ir ideāls testēšanai un atkļūdošanai, nerakstot kodu
- Autentificējies ar
-H "Authorization: Bearer $XAI_API_KEY" - Izmanto
jq, lai formatētu un filtrētu JSON atbildes - Sarežģītus pieprasījumus glabā atsevišķos JSON failos