Iarratas simplí POST /v1/responses
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026, bunaithe ar dhea-chleachtais xAI agus ar an tagairt API: tá an teocht teoranta ag 1, agus molann xAI 0.7 le
top_pag 0.95. Foinse: Dea-chleachtais.
Do chéad ghlao rathúil
Tá do chuntas, do eochair API, agus SDK suiteáilte agat. Tá sé in am do chéad iarratas a sheoladh chuig API Grok agus struchtúr an fhreagra a thuiscint. Díreoidh an ceacht seo ar an bpríomhphointe deiridh, /v1/responses, an ceann is nua-aimseartha agus is mó a moltar.
Struchtúr an iarratais
Glacann an pointe deiridh POST /v1/responses le dhá pharaiméadar ar a laghad:
model: ID an mhúnla le húsáidinput: téacs d’iarratais (nó eagar ábhair do chásanna casta)
Iarratas íosta i bPython
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)
Le treoracha córais
Ligeann an paraiméadar instructions duit iompar an mhúnla a shainiú:
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?"
)
Anatamaíocht an fhreagra
Tugann an API oibiacht JSON struchtúrtha ar ais. Seo na príomhréimsí:
{
"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
}
}
Réimsí tábhachtacha
id: ID uathúil an fhreagra, úsáideach chun é a aisghabháil níos déanaístatus:completednuair a bheidh an ghiniúint críochnaitheoutput: eagar ina bhfuil na teachtaireachtaí ginteusage: comhairitheoirí token chun do thomhaltas a rianú
Paraiméadair roghnacha coitianta
Rialú na cruthaitheachta
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # an luach a mholann xAI
top_p=0.95,
)
- Glacann an API le teocht ó 0 go 2, ach teorannaíonn sé aon luach níos airde ná sin ag 1
- Molann xAI
temperature=0.7agustop_p=0.95agus comhairlíonn sé gan imeacht uathu: de ghnáth, titfidh an cháilíocht - Chun níos mó cruthaitheachta a fháil, iarr é sa leid (“mol ainmneacha gan choinne”)
Teorainn a chur leis an bhfad
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Teorainn leis an bhfreagra
)
Réasúnaíocht a chur ar siúl
Do mhúnlaí réasúnaíochta, coigeartaigh an iarracht smaointeoireachta:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
Is iad low, medium, agus high na leibhéil is féidir a bheith ann.
Comhrá a leanúint
Tacaíonn an pointe deiridh /v1/responses le comhráite il-chasadh tríd an bparaiméadar previous_response_id:
# An chéad teachtaireacht
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# An dara teachtaireacht (cuimhníonn an múnla ar an gcomhthéacs)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Tá an cur chuige seo níos simplí ná stair na dteachtaireachtaí a bhainistiú leat féin.
Costais a rianú
Ligeann an réimse usage sa fhreagra duit costais gach glao a ríomh. Taispeánann an réimse output_tokens_details.reasoning_tokens cé mhéad token a chuaigh isteach i réasúnaíocht inmheánach an mhúnla (bíonn táille ar na token seo ach ní fheictear iad sa fhreagra).
Príomhphointí
- Is é an pointe deiridh
POST /v1/responsesan ceann is nua-aimseartha agus is mó a moltar - Dhá pharaiméadar riachtanacha:
modelagusinput - Tá an freagra le fáil in
output[0].content[0].text - Úsáid
previous_response_iddo chomhráite il-chasadh - Cabhraíonn an réimse
usageleat do thomhaltas token a rianú