Παράμετροι Αιτήματος
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση την αναφορά του Responses API και τις βέλτιστες πρακτικές της xAI: συνιστώμενη θερμοκρασία 0,7, με ανώτατο όριο το 1·
top_p0,95 ως προεπιλογή·max_output_tokensπεριορισμένο στην ορατή απάντηση (128.000 προεπιλογή, ο συλλογισμός εξαιρείται)· η προσπάθεια συλλογισμού (reasoning effort) προορίζεται για τα grok-4.5 έως 4.7. Πηγές: Responses API · Βέλτιστες πρακτικές.
Έλεγχος της συμπεριφοράς του μοντέλου
Πέρα από τα model, input και instructions, το Responses API προσφέρει πολυάριθμες παραμέτρους για τη λεπτομερή ρύθμιση της συμπεριφοράς του Grok. Η κατανόηση αυτών των παραμέτρων σας επιτρέπει να λαμβάνετε απαντήσεις πιο σχετικές, συντομότερες ή πιο δημιουργικές, ανάλογα με τις ανάγκες σας.
Παράμετροι δημιουργίας
temperature
Ελέγχει την τυχαιότητα των απαντήσεων. Το API δέχεται τιμές από 0 έως 2, αλλά οποιαδήποτε τιμή άνω του 1 δειγματοληπτείται ως 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Οι βέλτιστες πρακτικές της xAI είναι σαφείς: ορίστε το temperature στο 0,7 και μην αποκλίνετε σημαντικά από αυτό, καθώς τα μοντέλα Grok αντιδρούν αρνητικά σε άλλες ρυθμίσεις δειγματοληψίας. Για έναν πιο πραγματιστικό ή δημιουργικό τόνο, προσαρμόστε την εντολή (prompt) αντί για τη θερμοκρασία.
top_p
Δειγματοληψία πυρήνα (Nucleus sampling). Τα τρέχοντα μοντέλα κειμένου έχουν προεπιλογή το 0,95 και οποιαδήποτε τιμή υψηλότερη από την προεπιλογή του μοντέλου μειώνεται σε αυτήν.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Με top_p: 0.95, το μοντέλο λαμβάνει υπόψη μόνο τα tokens που αντιπροσωπεύουν το 95% της πιθανότητας. Η αναφορά του API επαναλαμβάνει την κλασική συμβουλή να προσαρμόζετε μόνο μία από τις δύο παραμέτρους· ωστόσο, οι βέλτιστες πρακτικές της xAI απαιτούν τον ρητό ορισμό και των δύο, στο 0,7 και στο 0,95 αντίστοιχα, σε κάθε αίτημα.
max_output_tokens
Περιορίζει τον αριθμό των tokens στην ορατή απάντηση· ο συλλογισμός και οι κλήσεις συναρτήσεων δεν υπολογίζονται, και η προεπιλεγμένη τιμή είναι 128.000 tokens:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Για τα μοντέλα συλλογισμού, η προσπάθεια συλλογισμού (reasoning effort) και όχι αυτό το όριο, διέπει την εσωτερική αναστοχαστική διαδικασία. Μια απάντηση που διακόπτεται λόγω του ορίου σηματοδοτείται με την κατάσταση incomplete.
reasoning
Για μοντέλα που υποστηρίζουν συλλογισμό, μπορείτε να προσαρμόσετε την προσπάθεια:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Οι πιθανές τιμές είναι low, medium και high (προεπιλογή), καθώς και xhigh στα grok-4.6 και grok-4.7· η παράμετρος εφαρμόζεται στα grok-4.5 έως 4.7, ενώ το grok-4.20-0309-reasoning δεν την δέχεται. Η υψηλή προσπάθεια καταναλώνει περισσότερα tokens και ενδείκνυται για σύνθετα προβλήματα.
Παράμετροι συνομιλίας
store
Καθορίζει εάν η απάντηση αποθηκεύεται στον διακομιστή:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: η απάντηση αποθηκεύεται για 30 ημέρες, είναι ανακτήσιμη μέσω GET και usable μεprevious_response_idfalse: η απάντηση δεν αποθηκεύεται μόνιμα (ιδιωτική λειτουργία)
previous_response_id
Συνδέει ένα νέο αίτημα με μια υπάρχουσα συνομιλία (αναλύεται λεπτομερώς στο μάθημα 5).
user
Αναγνωριστικό τελικού χρήστη, χρήσιμο για την παρακολούθηση και τη διαχείριση περιεχομένου:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Παράμετροι εργαλείων
tools, tool_choice, parallel_tool_calls, max_turns
Αυτές οι παράμετροι ελέγχουν τη χρήση εργαλείων (web_search, code_interpreter, προσαρμοσμένες συναρτήσεις). Καλύπτονται λεπτομερώς στην ενότητα «Εργαλεία» (μαθήματα 9-12).
Σύνοψη παραμέτρων
| Παράμετρος | Τύπος | Προεπιλογή | Χρήση |
|---|---|---|---|
model | string | required | Αναγνωριστικό μοντέλου |
input | string/array | required | Εντολή χρήστη |
instructions | string | null | Εντολή συστήματος |
temperature | number | — | Συνιστάται 0,7· ανώτατο όριο το 1 |
top_p | number | 0.95 | Δειγματοληψία πυρήνα |
max_output_tokens | integer | 128,000 | Όριο ορατής απάντησης |
reasoning | object | null | Προσπάθεια συλλογισμού |
store | boolean | null | Μόνιμη αποθήκευση 30 ημερών |
stream | boolean | false | Ροή SSE |
user | string | null | ID τελικού χρήστη |
Βασικά σημεία
- Η xAI συνιστά
temperatureστο 0,7 καιtop_pστο 0,95, με ρητό ορισμό - Το
max_output_tokensπεριορίζει μόνο την ορατή απάντηση, εξαιρώντας τον συλλογισμό - Το
store: trueδιατηρεί την απάντηση για 30 ημέρες, επιτρέποντας τη συνέχιση της συνομιλίας - Το
reasoning.effortσας επιτρέπει να κλιμακώνετε την αναστοχαστική ικανότητα του μοντέλου βάσει της πολυπλοκότητας του έργου - Η παράμετρος
userδιευκολύνει την παρακολούθηση και τη διαχείριση περιεχομένου από την πλευρά της xAI