Paprastas POST /v1/responses užklausos pavyzdys
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d., remiantis „xAI“ geriausiomis praktikomis ir API nuoroda: temperatūra ribojama iki 1, o „xAI“ rekomenduoja naudoti 0.7 kartu su
top_preikšme 0.95. Šaltinis: Geriausios praktikos.
Tavo pirmasis sėkmingas kvietimas
Turi paskyrą, API raktą ir įdiegtą SDK. Metas siųsti pirmąją užklausą „Grok“ API ir suprasti atsako struktūrą. Šioje pamokoje dėmesys skiriamas pagrindiniam galiniam taškui /v1/responses – tai moderniausias ir labiausiai rekomenduojamas būdas.
Užklausos struktūra
Galiniame taške POST /v1/responses būtina nurodyti bent du parametrus:
model: naudojamo modelio IDinput: tavo užklausos tekstas (arba turinio masyvas sudėtingesniais atvejais)
Minimali užklausa naudojant „Python“
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="What's the most widely used programming language in 2026?"
)
print(response.output[0].content[0].text)
Su sistemos instrukcijomis
Parametras instructions leidžia apibrėžti modelio elgseną:
response = client.responses.create(
model="grok-4.5",
instructions="You are a web development expert. Answer concisely.",
input="What's the difference between SSR and SSG?"
)
Atsako anatomija
API grąžina struktūrizuotą JSON objektą. Štai pagrindiniai laukai:
{
"id": "resp-abc123",
"object": "response",
"status": "completed",
"model": "grok-4.5",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "The model's answer appears here."
}
],
"status": "completed"
}
],
"usage": {
"input_tokens": 42,
"output_tokens": 156,
"total_tokens": 198
}
}
Svarbūs laukai
id: unikalus atsako ID, naudingas vėliau jį atkurtistatus:completed, kai generavimas baigtasoutput: masyvas, kuriame yra sugeneruoti pranešimaiusage: žetonų skaitikliai, padedantys stebėti tavo sunaudojimą
Dažni neprivalomi parametrai
Kūrybiškumo valdymas
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # „xAI“ rekomenduojama reikšmė
top_p=0.95,
)
- API priima temperatūros reikšmes nuo 0 iki 2, tačiau visas didesnes reikšmes apriboja iki 1
- „xAI“ rekomenduoja naudoti
temperature=0.7irtop_p=0.95bei pataria nuo jų nenukrypti: kokybė paprastai suprastėja - Jei nori daugiau kūrybiškumo, paprašyk to tiesiogiai užuominoje („pasiūlyk netikėtų pavadinimų“)
Ilgio ribojimas
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Atsakymo ilgio riba
)
Įjungimas samprotavimą
Samprotavimo modeliams gali reguliuoti mąstymo intensyvumą:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
Galimi lygiai trys lygiai: low, medium ir high.
Pokalbio tęsimas
Galutinis taškas /v1/responses palaiko daugkartinio keitimosi žinutėmis pokalbius naudodamas parametrą previous_response_id:
# Pirmoji žinutė
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Antroji žinutė (modelis prisimena kontekstą)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Šis būdas yra paprastesnis nei žinučių istorijos valdymas savo jėgomis.
Išlaidų stebėjimas
Atsako laukas usage leidžia apskaičiuoti kiekvieno kvietimo kainą. Laukas output_tokens_details.reasoning_tokens rodo, kiek žetonų buvo panaudota vidiniam modelio samprotavimui (šie žetonai apmokestinami, tačiau atsakyme nematomi).
Svarbiausi punktai
- Galutinis taškas
POST /v1/responsesyra moderniausias ir labiausiai rekomenduojamas - Du būtini parametrai:
modelirinput - Atsakymas randamas lauke
output[0].content[0].text - Naudok
previous_response_idpokalbiams, susidedantiems iš kelių etapų - Laukas
usagepadeda stebėti tavo sunaudojamus žetonus