Извикване на API с cURL
На тази страница
Универсалният инструмент за тестване на API
cURL е команден инструмент, наличен във всяка операционна система. Той Ви позволява да изпращате HTTP заявки, без да инсталирате SDK или да пишете програма. Това е идеалният инструмент за бързо тестване на крайна точка, отстраняване на грешки в заявката или автоматизиране на извиквания в shell скрипт.
Вашата първа cURL заявка
Ето как да изпратите заявка към Grok API с 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."}
]
}'
Разбиване на командата
curl https://api.x.ai/v1/chat/completions: изпраща POST заявка (подразбира се от-d) до крайната точка-H "Authorization: Bearer $XAI_API_KEY": добавя хедъра за удостоверяване с Вашия ключ-H "Content-Type: application/json": указва, че тялото е във формат JSON-d '{...}': тялото на заявката във формат JSON
Използване на крайната точка /v1/responses
Съвременната крайна точка /v1/responses предлага по-кратък синтаксис:
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."
}'
Обърнете внимание, че input замества messages за обикновени заявки. Можете да подадете низ директно, вместо масив от съобщения.
Полезни опции на cURL
Форматиране на JSON изхода
Суровият отговор е труден за четене. Използвайте 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 .
Опцията -s (silent) скрива лентата за напредък на cURL.
Извличане само на отговора
За да получите текста на отговора без метаданните:
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'
Преглед на хедърите на отговора
За отстраняване на грешки, свързани с лимити на скоростта или други проблеми, добавете -i, за да покажете 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"}'
Четене на тялото от файл
За сложни заявки съхранете JSON данните във файл:
# 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
}
След това го реферирайте с @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Отстраняване на често срещани грешки
- 401 Unauthorized: невалиден или липсващ API ключ. Проверете с
echo $XAI_API_KEY - 400 Bad Request: некоректен JSON. Валидирайте JSON с
jq . < request.json - 429 Too Many Requests: достигнали сте лимита на скоростта. Изчакайте няколко секунди
- 404 Not Found: проверете URL адреса и пътя до крайната точка
Ключови изводи
- cURL е идеален за тестване и отстраняване на грешки без писане на код
- Удостоверявайте се с
-H "Authorization: Bearer $XAI_API_KEY" - Използвайте
jq, за да форматирате и филтрирате JSON отговори - Съхранявайте сложните заявки в отделни JSON файлове