Izradi odgovor s POST /v1/responses
Na ovoj stranici
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š koristitiinput: 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:
- Koristi model
grok-4.20-0309-reasoning - Definira sistemske instrukcije za tehničkog asistenta
- 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/responsesglavna je krajnja točka – zahtijevamodeliinputinputprihvaća običan tekst ili strukturirani niz s ulogamainstructionsdefinira sistemsko ponašanje modela- Autentifikacija se odvija putem zaglavlja
Authorization: Bearer - OpenAI SDK kompatibilan je s xAI promjenom
base_url