Ένα απλό αίτημα POST /v1/responses
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 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