Премини към основното съдържание
Български— Изберете език
Меню

Извикване на API с cURL

Урок 8 от 14 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Универсалният инструмент за тестване на API
  2. Вашата първа cURL заявка
  3. Използване на крайната точка /v1/responses
  4. Полезни опции на cURL
  5. Четене на тялото от файл
  6. Отстраняване на често срещани грешки
  7. Ключови изводи

Универсалният инструмент за тестване на 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 файлове