Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kviesti API naudojant cURL

Paskaita 8 iš 14 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Universali priemonė API testavimui
  2. Tavo pirmoji cURL užklausa
  3. Naudok /v1/responses galinį tašką
  4. Naudingos cURL parinktys
  5. Skaityk kūną iš failo
  6. Derink įprastas klaidas
  7. Svarbiausi punktai

Universali priemonė API testavimui

cURL yra komandinės eilutės įrankis, prieinamas visose operacinėse sistemose. Jis leidžia siųsti HTTP užklausas neinstaliuojant SDK ir nerašant programos. Tai idealus įrankis greitai patikrinti galinį tašką (endpoint), derinti užklausas arba automatizuoti kvietimus apvalkalo (shell) scenarijuose.

Tavo pirmoji cURL užklausa

Štai kaip siųsti užklausą į Grok API naudojant 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."}
    ]
  }'

Komandos analizė

  • curl https://api.x.ai/v1/chat/completions: siunčia POST užklausą (numanoma dėl -d) į galinį tašką
  • -H "Authorization: Bearer $XAI_API_KEY": prideda autentifikavimo antraštę su tavo raktu
  • -H "Content-Type: application/json": nurodo, kad kūnas yra JSON formato
  • -d '{...}': užklausos kūnas JSON formatu

Naudok /v1/responses galinį tašką

Šiuolaikinis /v1/responses galinis taškas siūlo glaustesnę sintaksę:

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."
  }'

Atkreipk dėmesį, kad paprastoms užklausoms input pakeičia messages. Vietoj žinučių masyvo gali perduoti tiesioginę eilutę.

Naudingos cURL parinktys

Formatuok JSON išvestį

Neapdorotą atsakymą sunku skaityti. Naudok jq, kad jį suformatuotum:

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 .

Parinktis -s (tylus) paslepia cURL eigos juostą.

Ištrauk tik atsakymą

Norint gauti atsakymo tekstą be metaduomenų:

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'

Peržiūrėk atsakymo antraštes

Norint derinti spartos ribas ar klaidas, pridėk -i, kad būtų rodomos HTTP antraštės:

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"}'

Skaityk kūną iš failo

Sudėtingoms užklausoms JSON duomenis išsaugok faile:

# 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
}

Tada nurodyk jį naudodamas @:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Derink įprastas klaidas

  • 401 Unauthorized: neteisingas arba trūkstamas API raktas. Patikrink naudodamas echo $XAI_API_KEY
  • 400 Bad Request: neteisingai suformuotas JSON. Patikrink savo JSON naudodamas jq . < request.json
  • 429 Too Many Requests: viršijai spartos ribą. Palauk kelias sekundes
  • 404 Not Found: patikrink URL ir galinio taško kelią

Svarbiausi punktai

  • cURL puikiai tinka testavimui ir derinimui nerašant kodo
  • Autentifikuokis naudodamas -H "Authorization: Bearer $XAI_API_KEY"
  • Naudok jq JSON atsakymams formatuoti ir filtruoti
  • Sudėtingas užklausas saugok atskiruose JSON failuose