Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Izradi odgovor s POST /v1/responses

Lekcija 2 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Tvoj prvi zahtjev
  2. Autentifikacija
  3. Minimalni zahtjev
  4. S Python SDK-om
  5. Jednostavan nasuprot strukturiranom unosu
  6. Parametar instructions
  7. Praktična vježba
  8. Ključne točke

Tvoj prvi zahtjev

Krajnja točka POST /v1/responses glavni je ulaz za API odgovora (Responses API). Ovdje šalješ svoje upite (promptove) i primaš odgovore od modela Grok. U ovoj lekciji naučit ćeš kako izgraditi i poslati svoj prvi zahtjev.

Autentifikacija

Svi zahtjevi zahtijevaju zaglavlje za autentifikaciju s tvojim xAI API ključem:

Authorization: Bearer $XAI_API_KEY

Ključeve možeš generirati na console.x.ai. Čuvaj ih u tajnosti – nikada ih ne dodajuj u Git repozitorij.

Minimalni zahtjev

Evo najjednostavnijeg mogućeg zahtjeva:

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

Dva polja su dovoljna:

  • model: ID Grok modela koji želiš koristiti
  • input: tvoj upit, kao običan tekst

S Python SDK-om

Ako koristiš OpenAI SDK (kompatibilan s xAI), sintaksa je slična:

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)

Jednostavan nasuprot strukturiranom unosu

Parametar input prihvaća dva formata.

Običan tekst

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

Strukturirani niz

Za multimodalne unose ili eksplicitne uloge:

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

Format niza daje ti veću kontrolu, posebno za uključivanje slika ili specificiranje različitih uloga.

Parametar instructions

Da bi modelu dodijelio/la sistemsko ponašanje, koristi instructions umjesto dodavanja sistemske poruke u 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 ekvivalentno je system promptu u Chat Completions. Ono definira opće ponašanje modela za cijeli razgovor.

Praktična vježba

Pokušaj izgraditi zahtjev koji:

  1. Koristi model grok-4.20-0309-reasoning
  2. Definira sistemske instrukcije za tehničkog asistenta
  3. Postavlja pitanje 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 točke

  • POST /v1/responses glavna je krajnja točka – zahtijeva model i input
  • input prihvaća običan tekst ili strukturirani niz s ulogama
  • instructions definira sistemsko ponašanje modela
  • Autentifikacija se odvija putem zaglavlja Authorization: Bearer
  • OpenAI SDK kompatibilan je s xAI promjenom base_url