Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kutsu API-d cURL-iga

Õppetund 8 / 14 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Universaalne tööriist API-de testimiseks
  2. Sinu esimene cURL-päring
  3. Kasuta /v1/responses lõpp-punkti
  4. Kasulikud cURL-i valikud
  5. Loegi keha failist
  6. Levinud vigade silumine
  7. Peamised punktid

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