Vienkāršs POST /v1/responses pieprasījums
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI labākajām praksēm un API atsauces dokumentāciju: temperatūra ir ierobežota līdz 1, un xAI iesaka izmantot 0.7 ar
top_pvērtību 0.95. Avots: Labākās prakses.
Tavs pirmais veiksmīgais izsaukums
Tev ir konts, API atslēga un instalēts SDK. Ir laiks nosūtīt savu pirmo pieprasījumu Grok API un saprast atbildes struktūru. Šī nodarbība fokusējas uz galveno galapunktu /v1/responses, kas ir vismodernākais un visvairāk ieteicamais.
Pieprasījuma struktūra
Galapunkts POST /v1/responses pieņem vismaz divus parametrus:
model: izmantojamā modeļa IDinput: tava pieprasījuma teksts (vai satura masīvs sarežģītākos gadījumos)
Minimāls pieprasījums Python valodā
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)
Ar sistēmas instrukcijām
Parametrs instructions ļauj definēt modeļa uzvedību:
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?"
)
Atbildes uzbūve
API atgriež strukturētu JSON objektu. Lūk, galvenie lauki:
{
"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
}
}
Svarīgi lauki
id: unikālais atbildes ID, noderīgs tās vēlākai izgūšanaistatus:completed, kad ģenerēšana ir pabeigtaoutput: masīvs, kas satur ģenerētos ziņojumususage: tokena skaitītāji tava patēriņa izsekošanai
Bieži lietoti opcionālie parametri
Kreativitates kontrole
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # vērtība, ko iesaka xAI
top_p=0.95,
)
- API pieņem temperatūru no 0 līdz 2, bet jebkuru augstāku vērtību ierobežo līdz 1
- xAI iesaka
temperature=0.7untop_p=0.95un attur no novirzīšanās no šīm vērtībām: kvalitāte parasti pasliktinās - Lai panāktu lielāku kreativitati, lūdz to tieši promptā („iedomājies negaidītus nosaukumus”)
Garuma ierobežošana
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Ierobežo atbildi
)
Spriešanas spēju aktivizēšana
Spriešanas modeļiem pielāgo domāšanas intensitāti:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
Iespējamie līmeņi ir low, medium un high.
Sarunas turpināšana
Galapunkts /v1/responses atbalsta daudzpakāpju sarunas, izmantojot parametru previous_response_id:
# Pirmais ziņojums
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Otrais ziņojums (modelis atceras kontekstu)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Šī pieeja ir vienkāršāka nekā ziņojumu vēstures pārvaldīšana pašrocīgi.
Izmaksu izsekošana
Lauks usage atbildē ļauj aprēķināt katra izsaukuma izmaksas. Lauks output_tokens_details.reasoning_tokens parāda, cik tokeni tika izmantoti modeļa iekšējai spriešanai (šie tokeni tiek apmaksāti, bet neparādās atbildē).
Galvenās atziņas
- Galapunkts
POST /v1/responsesir vismodernākais un visvairāk ieteicamais - Divi obligāti parametri:
modeluninput - Atbilde atrodama
output[0].content[0].text - Daudzpakāpju sarunām izmanto
previous_response_id - Lauks
usagepalīdz izsekot tava tokena patēriņu