Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Ustvari odgovor s POST /v1/responses

Lekcija 2 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Tvoja prva zahteva
  2. Avtentikacija
  3. Minimalna zahteva
  4. S Python SDK-jem
  5. Preprost proti strukturiranemu vnosu
  6. Parameter instructions
  7. Praktična vaja
  8. Ključne ugotovitve

Tvoja prva zahteva

Končna točka POST /v1/responses je glavni vstopni punkt za API za odgovore. Sem pošiljaš svoje pozive in prejemaš odgovore od modelov Grok. V tej lekciji se boš naučil, kako zgraditi in poslati svojo prvo zahtevo.

Avtentikacija

Vse zahteve zahtevajo glavo za avtentikacijo s tvojim ključem API xAI:

Authorization: Bearer $XAI_API_KEY

Svoje ključe lahko ustvariš na console.x.ai. Hrani jih v tajnosti – nikoli jih ne potisni v repozitorij Git.

Minimalna zahteva

Tukaj je najpreprostejša možna zahteva:

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

Dovolj sta dve polji:

  • model: ID modela Grok, ki ga želiš uporabiti
  • input: tvoj poziv kot navadno besedilo

S Python SDK-jem

Če uporabljaš OpenAI SDK (združljiv z xAI), je sintaksa podobna:

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)

Preprost proti strukturiranemu vnosu

Parameter input sprejema dve obliki.

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

Strukturirano polje

Za večmodalne vnose ali eksplicitne vloge:

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

Oblika s poljem ti daje več nadzora, še posebej pri vključevanju slik ali določanju različnih vlog.

Parameter instructions

Če želiš modelu dodeliti sistemsko vedenje, uporabi instructions namesto dodajanja sistemskega sporočila v 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?"
}

Polje instructions je enakovredno system prompt pri dopolnjevanju klepetov (Chat Completions). Opredeljuje splošno vedenje modela za celoten pogovor.

Praktična vaja

Poskusi zgraditi zahtevo, ki:

  1. Uporablja model grok-4.20-0309-reasoning
  2. Določi sistemska navodila za tehničnega asistenta
  3. Postavi vprašanje o Pythonu
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?"
  }'

Ključne ugotovitve

  • POST /v1/responses je glavna končna točka – zahteva model in input
  • input sprejema navadno besedilo ali strukturirano polje z vlogami
  • instructions določa sistemsko vedenje modela
  • Avtentikacija poteka prek glave Authorization: Bearer
  • OpenAI SDK je združljiv z xAI s spremembo base_url