Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cruthaigh freagra le POST /v1/responses

Ceacht 2 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Do chéad iarratas
  2. Fíordheimhniú
  3. Iarratas íosta
  4. Leis an SDK Python
  5. Ionchur simplí vs struchtúrtha
  6. An paraiméadar treoracha
  7. Cleachtas praiticiúil
  8. Príomhphointí

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áid
  • input: 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:

  1. Úsáideann an múnla grok-4.20-0309-reasoning
  2. Sainíonn treoracha córais do chúntóir teicniúil
  3. 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/responses an príomhphointe deiridh—éilíonn sé model agus input
  • Glacann input le téacs simplí nó le heagar struchtúrtha le róil
  • Sainíonn instructions iompar 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