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

Δημιουργία απόκρισης με POST /v1/responses

Μάθημα 2 / 16 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το πρώτο σας αίτημα
  2. Πιστοποίηση
  3. Ελάχιστο αίτημα
  4. Με το Python SDK
  5. Απλή έναντι δομημένης εισόδου
  6. Η παράμετρος instructions
  7. Πρακτική άσκηση
  8. Βασικά σημεία

Το πρώτο σας αίτημα

Το 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. Ορίζει τη συνολική συμπεριφορά του μοντέλου για ολόκληρη τη συνομιλία.

Πρακτική άσκηση

Δοκιμάστε να δημιουργήσετε ένα αίτημα που:

  1. Χρησιμοποιεί το μοντέλο grok-4.20-0309-reasoning
  2. Ορίζει οδηγίες συστήματος για έναν τεχνικό βοηθό
  3. Κάνει μια ερώτηση σχετικά με την 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