Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Κλήση του API με cURL

Μάθημα 8 / 14 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το καθολικό εργαλείο για δοκιμές API
  2. Το πρώτο σας αίτημα cURL
  3. Χρήση του endpoint /v1/responses
  4. Χρήσιμες επιλογές του cURL
  5. Ανάγνωση του σώματος από αρχείο
  6. Αποσφαλμάτωση συνηθισμένων σφαλμάτων
  7. Βασικά σημεία

Το καθολικό εργαλείο για δοκιμές 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