Δημιουργία απόκρισης με POST /v1/responses
Σε αυτήν τη σελίδα
Το πρώτο σας αίτημα
Το endpoint POST /v1/responses αποτελεί την κύρια είσοδο για το API Αποκρίσεων (Responses API). Εδώ στέλνετε τις εντολές (prompts) σας και λαμβάνετε αποκρίσεις από τα μοντέλα Grok. Σε αυτό το μάθημα, θα μάθετε πώς να δομείτε και να στέλνετε το πρώτο σας αίτημα.
Πιστοποίηση
Όλα τα αιτήματα απαιτούν μια κεφαλίδα πιστοποίησης με το κλειδί API του xAI:
Authorization: Bearer $XAI_API_KEY
Μπορείτε να δημιουργήσετε τα κλειδιά σας στο console.x.ai. Διατηρήστε τα μυστικά· μην τα κάνετε ποτέ commit σε αποθετήριο Git.
Ελάχιστο αίτημα
Ορίστε το απλούστερο δυνατό αίτημα:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"input": "Explain what machine learning is in 3 sentences."
}'
Δύο πεδία αρκούν:
model: το αναγνωριστικό (ID) του μοντέλου Grok που θα χρησιμοποιηθείinput: η εντολή (prompt) σας, ως απλό κείμενο
Με το Python SDK
Εάν χρησιμοποιείτε το OpenAI SDK (συμβατό με xAI), η σύνταξη είναι παρόμοια:
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Explain what machine learning is in 3 sentences."
)
print(response.output[0].content[0].text)
Απλή έναντι δομημένης εισόδου
Η παράμετρος input δέχεται δύο μορφές.
Απλό κείμενο
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?"
}
Δομημένος πίνακας
Για πολυτροπικές εισόδους (multimodal) ή ρητούς ρόλους:
{
"model": "grok-4.20-0309-reasoning",
"input": [
{
"role": "user",
"content": "Analyze this image and describe what you see."
}
]
}
Η μορφή πίνακα σας προσφέρει μεγαλύτερο έλεγχο, ειδικά για τη συμπερίληψη εικόνων ή τον καθορισμό διαφορετικών ρόλων.
Η παράμετρος instructions
Για να ορίσετε τη συμπεριφορά συστήματος του μοντέλου, χρησιμοποιήστε το instructions αντί να προσθέσετε ένα μήνυμα συστήματος στο input:
{
"model": "grok-4.20-0309-reasoning",
"instructions": "You are a French cuisine expert. Always respond including a chef's tip.",
"input": "How do I make a successful béchamel?"
}
Το πεδίο instructions ισοδυναμεί με το system prompt στα Chat Completions. Ορίζει τη συνολική συμπεριφορά του μοντέλου για ολόκληρη τη συνομιλία.
Πρακτική άσκηση
Δοκιμάστε να δημιουργήσετε ένα αίτημα που:
- Χρησιμοποιεί το μοντέλο
grok-4.20-0309-reasoning - Ορίζει οδηγίες συστήματος για έναν τεχνικό βοηθό
- Κάνει μια ερώτηση σχετικά με την Python
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"instructions": "You are a senior Python developer. Give concise code examples.",
"input": "How do I read a JSON file in Python?"
}'
Βασικά σημεία
- Το
POST /v1/responsesείναι το κύριο endpoint· απαιτεί ταmodelκαιinput - Το
inputδέχεται απλό κείμενο ή έναν δομημένο πίνακα με ρόλους - Το
instructionsορίζει τη συμπεριφορά συστήματος του μοντέλου - Η πιστοποίηση γίνεται μέσω της κεφαλίδας
Authorization: Bearer - Το OpenAI SDK είναι συμβατό με το xAI αλλάζοντας το
base_url