Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izsauc API ar cURL

Nodarbība 8 no 14 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Universālais rīks API testēšanai
  2. Tavs pirmais cURL pieprasījums
  3. Izmanto /v1/responses galapunktu
  4. Noderīgas cURL opcijas
  5. Lasī ķermeni no faila
  6. Atkļūdo biežākās kļūdas
  7. Galvenās atziņas

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