Apelarea API-ului cu cURL
Pe această pagină
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
jqpentru a formata și filtra răspunsurile JSON - Stocați cererile complexe în fișiere JSON separate