Cruthaigh freagra le POST /v1/responses
Ar an leathanach seo
Do chéad iarratas
Is é an t-iontráil phríomhúil don API Freagraí ná an pointe deiridh POST /v1/responses. Seo an áit a seolann tú do leideanna (prompts) agus a fhaigheann tú freagraí ó mhúnlaí Grok. Sa cheacht seo, foghlaimeoidh tú conas do chéad iarratas a thógáil agus a sheoladh.
Fíordheimhniú
Éilíonn gach iarratas ceanntásc fíordheimhnithe le do eochair API xAI:
Authorization: Bearer $XAI_API_KEY
Is féidir leat do chuid eochracha a ghiniúint ag console.x.ai. Coinnigh faoi rún iad—ná déan iad a chur riamh i stór Git.
Iarratas íosta
Seo an t-iarratas is simplí is féidir a dhéanamh:
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."
}'
Tá dhá réimse go leor:
model: ID an mhúnla Grok le húsáidinput: do leid, mar théacs simplí
Leis an SDK Python
Má úsáideann tú an OpenAI SDK (atá comhoiriúnach le xAI), tá an chomhréir cosúil:
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)
Ionchur simplí vs struchtúrtha
Glacann an paraiméadar input le dhá fhormáid.
Téacs simplí
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?"
}
Eagar struchtúrtha
Le haghaidh ionchuir ilmhóideacha nó róil shainráite:
{
"model": "grok-4.20-0309-reasoning",
"input": [
{
"role": "user",
"content": "Analyze this image and describe what you see."
}
]
}
Tugann an fhormáid eagraíochta níos mó smachta duit, go háirithe chun íomhánna a chur san áireamh nó róil éagsúla a shonrú.
An paraiméadar treoracha
Chun iompar córais a thabhairt don mhúnla, úsáid instructions seachas teachtaireacht chórais a chur le 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?"
}
Tá an réimse instructions coibhéiseach leis an system prompt i gComhlánuithe Comhrá. Sainíonn sé iompar foriomlán an mhúnla don chomhrá ar fad.
Cleachtas praiticiúil
Bain triail as iarratas a thógáil a:
- Úsáideann an múnla
grok-4.20-0309-reasoning - Sainíonn treoracha córais do chúntóir teicniúil
- Fiafraíonn ceiste faoi Python
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?"
}'
Príomhphointí
- Is é
POST /v1/responsesan príomhphointe deiridh—éilíonn sémodelagusinput - Glacann
inputle téacs simplí nó le heagar struchtúrtha le róil - Sainíonn
instructionsiompar córais an mhúnla - Tarlaíonn an fíordheimhniú tríd an gceanntásc
Authorization: Bearer - Tá an OpenAI SDK comhoiriúnach le xAI trí athrú a dhéanamh ar an
base_url