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

Ένα απλό αίτημα POST /v1/responses

Μάθημα 9 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Η πρώτη σας επιτυχημένη κλήση
  2. Δομή του αιτήματος
  3. Ανατομία της απόκρισης
  4. Κοινές προαιρετικές παράμετροι
  5. Συνέχεια μιας συνομιλίας
  6. Παρακολούθηση κόστους
  7. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026, με βάση τις βέλτιστες πρακτικές και την αναφορά API της xAI: η θερμοκρασία (temperature) περιορίζεται στο 1, και η xAI συνιστά τιμή 0.7 με top_p στο 0.95. Πηγή: Βέλτιστες πρακτικές.

Η πρώτη σας επιτυχημένη κλήση

Έχετε πλέον τον λογαριασμό σας, το κλειδί API σας και ένα SDK εγκατεστημένο. Ήρθε η ώρα να στείλετε το πρώτο σας αίτημα στο Grok API και να κατανοήσετε τη δομή της απόκρισης. Αυτό το μάθημα εστιάζει στο κύριο σημείο πρόσβασης (endpoint), το /v1/responses, το οποίο είναι το πιο σύγχρονο και το πιο συνιστώμενο.

Δομή του αιτήματος

Το σημείο πρόσβασης POST /v1/responses δέχεται τουλάχιστον δύο παραμέτρους:

  • model: το αναγνωριστικό (ID) του μοντέλου που θα χρησιμοποιηθεί
  • input: το κείμενο του αιτήματός σας (ή ένας πίνακας περιεχομένου για προχωρημένες περιπτώσεις)

Ελάχιστο αίτημα σε Python

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="What's the most widely used programming language in 2026?"
)

print(response.output[0].content[0].text)

Με οδηγίες συστήματος

Η παράμετρος instructions σας επιτρέπει να ορίσετε τη συμπεριφορά του μοντέλου:

response = client.responses.create(
    model="grok-4.5",
    instructions="You are a web development expert. Answer concisely.",
    input="What's the difference between SSR and SSG?"
)

Ανατομία της απόκρισης

Το API επιστρέφει ένα δομημένο αντικείμενο JSON. Ακολουθούν τα κύρια πεδία:

{
  "id": "resp-abc123",
  "object": "response",
  "status": "completed",
  "model": "grok-4.5",
  "output": [
    {
      "type": "message",
      "content": [
        {
          "type": "output_text",
          "text": "The model's answer appears here."
        }
      ],
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 42,
    "output_tokens": 156,
    "total_tokens": 198
  }
}

Σημαντικά πεδία

  • id: το μοναδικό αναγνωριστικό της απόκρισης, χρήσιμο για την ανάκτησή της αργότερα
  • status: completed όταν η παραγωγή έχει ολοκληρωθεί
  • output: ένας πίνακας που περιέχει τα παραγόμενα μηνύματα
  • usage: μετρητές token για την παρακολούθηση της κατανάλωσής σας

Κοινές προαιρετικές παράμετροι

Έλεγχος της δημιουργικότητας

response = client.responses.create(
    model="grok-4.5",
    input="Suggest a name for an AI startup.",
    temperature=0.7,  # the value xAI recommends
    top_p=0.95,
)
  • Το API δέχεται θερμοκρασία από 0 έως 2, αλλά περιορίζει οποιαδήποτε υψηλότερη τιμή στο 1
  • Η xAI συνιστά temperature=0.7 και top_p=0.95 και συμβουλεύει να μην αποκλίνετε από αυτές: η ποιότητα συνήθως μειώνεται
  • Για περισσότερη δημιουργικότητα, ζητήστε την απευθείας στο prompt («προτείνετε απροσδόκητα ονόματα»)

Περιορισμός του μήκους

response = client.responses.create(
    model="grok-4.5",
    input="Summarize the concept of machine learning.",
    max_output_tokens=200  # Caps the answer
)

Ενεργοποίηση συλλογισμού

Για μοντέλα συλλογισμού, ρυθμίστε την προσπάθεια σκέψης:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Solve this problem: if 3x + 7 = 22, what is x?",
    reasoning={"effort": "high"}
)

Τα πιθανά επίπεδα είναι low, medium και high.

Συνέχεια μιας συνομιλίας

Το σημείο πρόσβασης /v1/responses υποστηρίζει συνομιλίες πολλαπλών γύρων μέσω της παραμέτρου previous_response_id:

# First message
r1 = client.responses.create(
    model="grok-4.5",
    input="I'm building an API in Python."
)

# Second message (the model remembers the context)
r2 = client.responses.create(
    model="grok-4.5",
    input="Which framework do you recommend?",
    previous_response_id=r1.id
)

Αυτή η προσέγγιση είναι απλούστερη από τη διαχείριση του ιστορικού μηνυμάτων από εσάς.

Παρακολούθηση κόστους

Το πεδίο usage στην απόκριση σας επιτρέπει να υπολογίσετε το κόστος κάθε κλήσης. Το πεδίο output_tokens_details.reasoning_tokens δείχνει πόσα token χρησιμοποιήθηκαν για τον εσωτερικό συλλογισμό του μοντέλου (αυτά τα token χρεώνονται αλλά δεν εμφανίζονται στην απάντηση).

Βασικά σημεία

  • Το σημείο πρόσβασης POST /v1/responses είναι το πιο σύγχρονο και το πιο συνιστώμενο
  • Δύο απαιτούμενες παράμετροι: model και input
  • Η απάντηση βρίσκεται στο output[0].content[0].text
  • Χρησιμοποιήστε το previous_response_id για συνομιλίες πολλαπλών γύρων
  • Το πεδίο usage σας βοηθά να παρακολουθείτε την κατανάλωση token