Salt la conținutul principal
Română— Alege o limbă
Meniu

Apelarea API-ului cu cURL

Lecția 8 din 14 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Instrumentul universal pentru testarea API-urilor
  2. Prima dumneavoastră cerere cURL
  3. Utilizarea endpoint-ului /v1/responses
  4. Opțiuni cURL utile
  5. Citirea corpului dintr-un fișier
  6. Depanarea erorilor comune
  7. Puncte cheie

Instrumentul universal pentru testarea API-urilor

cURL este un utilitar din linia de comandă disponibil pe orice sistem de operare. Acesta vă permite să trimiteți cereri HTTP fără a instala un SDK sau a scrie un program. Este instrumentul ideal pentru testarea rapidă a unui endpoint, depanarea unei cereri sau automatizarea apelurilor într-un script shell.

Prima dumneavoastră cerere cURL

Iată cum să trimiteți o cerere către API-ul Grok folosind 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."}
    ]
  }'

Analiza comenzii

  • curl https://api.x.ai/v1/chat/completions: trimite o cerere POST (implicată de -d) către endpoint
  • -H "Authorization: Bearer $XAI_API_KEY": adaugă antetul de autentificare cu cheia dumneavoastră
  • -H "Content-Type: application/json": specifică faptul că corpul cererii este în format JSON
  • -d '{...}': corpul cererii în format JSON

Utilizarea endpoint-ului /v1/responses

Endpoint-ul modern /v1/responses oferă o sintaxă mai concisă:

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

Rețineți că input înlocuiește messages pentru cererile simple. Puteți transmite direct un șir de caractere în loc de un tablou de mesaje.

Opțiuni cURL utile

Formatarea ieșirii JSON

Răspunsul brut este greu de citit. Folosiți jq pentru a-l formata:

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 .

Opțiunea -s (silent) ascunde bara de progres a cURL.

Extragerea doar a răspunsului

Pentru a obține textul răspunsului fără metadate:

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'

Vizualizarea anteturilor de răspuns

Pentru a depana limitele de rată sau erorile, adăugați -i pentru a afișa anteturile 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"}'

Citirea corpului dintr-un fișier

Pentru cereri complexe, stocați JSON-ul într-un fișier:

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

Apoi faceți referire la el folosind @:

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

Depanarea erorilor comune

  • 401 Unauthorized: cheie API invalidă sau lipsă. Verificați cu echo $XAI_API_KEY
  • 400 Bad Request: JSON malformat. Validați JSON-ul cu jq . < request.json
  • 429 Too Many Requests: ați atins limita de rată. Așteptați câteva secunde
  • 404 Not Found: verificați URL-ul și calea endpoint-ului

Puncte cheie

  • cURL este perfect pentru testare și depanare fără a scrie cod
  • Autentificați-vă cu -H "Authorization: Bearer $XAI_API_KEY"
  • Folosiți jq pentru a formata și filtra răspunsurile JSON
  • Stocați cererile complexe în fișiere JSON separate