Κλήση του API με cURL
Σε αυτήν τη σελίδα
Το καθολικό εργαλείο για δοκιμές API
Το cURL είναι ένα εργαλείο γραμμής εντολών διαθέσιμο σε κάθε λειτουργικό σύστημα. Σας επιτρέπει να στέλνετε αιτήματα HTTP χωρίς να εγκαθιστάτε ένα SDK ή να γράφετε πρόγραμμα. Είναι το ιδανικό εργαλείο για γρήγορη δοκιμή ενός endpoint, αποσφαλμάτωση ενός αιτήματος ή αυτοματοποίηση κλήσεων σε ένα script κελύφους.
Το πρώτο σας αίτημα cURL
Ορίστε πώς να στείλετε ένα αίτημα στο Grok API με το 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."}
]
}'
Ανάλυση της εντολής
curl https://api.x.ai/v1/chat/completions: στέλνει ένα αίτημα POST (υπονοείται από το-d) στο endpoint-H "Authorization: Bearer $XAI_API_KEY": προσθέτει την κεφαλίδα πιστοποίησης με το κλειδί σας-H "Content-Type: application/json": δηλώνει ότι το σώμα είναι JSON-d '{...}': το σώμα του αιτήματος σε μορφή JSON
Χρήση του endpoint /v1/responses
Το σύγχρονο endpoint /v1/responses προσφέρει μια πιο συνοπτική σύνταξη:
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."
}'
Σημειώστε ότι το input αντικαθιστά το messages για απλά αιτήματα. Μπορείτε να περάσετε μια συμβολοσειρά απευθείας αντί για έναν πίνακα μηνυμάτων.
Χρήσιμες επιλογές του cURL
Μορφοποίηση της εξόδου JSON
Η ακατέργαστη απόκριση είναι δύσκολο να διαβαστεί. Χρησιμοποιήστε το jq για να τη μορφοποιήσετε:
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 .
Η επιλογή -s (silent) αποκρύπτει τη γραμμή προόδου του cURL.
Εξαγωγή μόνο της απάντησης
Για να λάβετε το κείμενο της απάντησης χωρίς τα μεταδεδομένα:
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'
Προβολή των κεφαλίδων απόκρισης
Για αποσφαλμάτωση ορίων ρυθμού ή σφαλμάτων, προσθέστε το -i για να εμφανιστούν οι κεφαλίδες 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"}'
Ανάγνωση του σώματος από αρχείο
Για σύνθετα αιτήματα, αποθηκεύστε το JSON σε ένα αρχείο:
# 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
}
Στη συνέχεια, αναφερθείτε σε αυτό με το @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Αποσφαλμάτωση συνηθισμένων σφαλμάτων
- 401 Unauthorized: μη έγκυρο ή λείπον κλειδί API. Ελέγξτε με
echo $XAI_API_KEY - 400 Bad Request: κακοδιατυπωμένο JSON. Επικυρώστε το JSON σας με
jq . < request.json - 429 Too Many Requests: ξεπεράσατε το όριο ρυθμού. Περιμένετε λίγα δευτερόλεπτα
- 404 Not Found: ελέγξτε το URL και τη διαδρομή του endpoint
Βασικά σημεία
- Το cURL είναι ιδανικό για δοκιμές και αποσφαλμάτωση χωρίς συγγραφή κώδικα
- Πιστοποιηθείτε χρησιμοποιώντας
-H "Authorization: Bearer $XAI_API_KEY" - Χρησιμοποιήστε το
jqγια μορφοποίηση και φιλτράρισμα αποκρίσεων JSON - Αποθηκεύστε σύνθετα αιτήματα σε ξεχωριστά αρχεία JSON