Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Válasz létrehozása a POST /v1/responses végponttal

2. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Az első kérésed
  2. Hitelesítés
  3. Minimális kérés
  4. A Python SDK használatával
  5. Egyszerű vs. strukturált bemenet
  6. Az instructions paraméter
  7. Gyakorlati feladat
  8. Főbb megállapítások

Az első kérésed

A POST /v1/responses végpont a Responses API fő belépési pontja. Ide küldöd el a promptjaidat, és innen kapod meg a Grok modellek válaszait. Ebben a leckében megtanulod, hogyan építsd fel és küldd el az első kérésedet.

Hitelesítés

Minden kéréshez szükség van egy hitelesítési fejlécre, amely tartalmazza az xAI API-kulcsodat:

Authorization: Bearer $XAI_API_KEY

A kulcsokat a console.x.ai oldalon generálhatod le. Tartsd őket titokban – soha ne commitold őket Git tárolóba.

Minimális kérés

Íme a lehető legegyszerűbb kérés:

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."
  }'

Két mező elegendő:

  • model: a használni kívánt Grok modell azonosítója
  • input: a promptod egyszerű szövegként

A Python SDK használatával

Ha az OpenAI SDK-t használod (amely kompatibilis az xAI-val), a szintaxis hasonló:

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)

Egyszerű vs. strukturált bemenet

Az input paraméter két formátumot fogad el.

Egyszerű szöveg

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?"
}

Strukturált tömb

Többmódusú (multimodális) bemenetekhez vagy explicit szerepek meghatározásához:

{
  "model": "grok-4.20-0309-reasoning",
  "input": [
    {
      "role": "user",
      "content": "Analyze this image and describe what you see."
    }
  ]
}

A tömbös formátum nagyobb kontrollt biztosít, különösen képek beszúrásakor vagy különböző szerepek meghatározásakor.

Az instructions paraméter

Ha rendszer-szintű viselkedést szeretnél megadni a modellnek, az instructions mezőt használd ahelyett, hogy rendszerüzenetet adnál hozzá az inputhoz:

{
  "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?"
}

Az instructions mező egyenértékű a Chat Completions API system promptjával. Ez határozza meg a modell általános viselkedését a teljes beszélgetés során.

Gyakorlati feladat

Próbálj meg összeállítani egy olyan kérést, amely:

  1. A grok-4.20-0309-reasoning modellt használja
  2. Rendszerutasításokat definiál egy technikai asszisztens számára
  3. Feltesz egy kérdést Pythonnal kapcsolatban
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?"
  }'

Főbb megállapítások

  • A POST /v1/responses a fő végpont – megköveteli a model és az input mezőket
  • Az input elfogad egyszerű szöveget vagy szerepeket tartalmazó strukturált tömböt
  • Az instructions határozza meg a modell rendszer-szintű viselkedését
  • A hitelesítés az Authorization: Bearer fejlécen keresztül történik
  • Az OpenAI SDK az base_url módosításával kompatibilissé tehető az xAI-val