Ustvari odgovor s POST /v1/responses
Na tej strani
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š uporabitiinput: 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.
Navadno besedilo
{
"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:
- Uporablja model
grok-4.20-0309-reasoning - Določi sistemska navodila za tehničnega asistenta
- 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/responsesje glavna končna točka – zahtevamodelininputinputsprejema navadno besedilo ali strukturirano polje z vlogamiinstructionsdoloča sistemsko vedenje modela- Avtentikacija poteka prek glave
Authorization: Bearer - OpenAI SDK je združljiv z xAI s spremembo
base_url