Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Oħloq tweġiba b'POST /v1/responses

Lezzjoni 2 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-ewwel talba tiegħek
  2. Awtentikazzjoni
  3. Talba minima
  4. Mas-SDK tal-Python
  5. Input sempliċi vs strutturat
  6. Il-parametru tal-istruzzjonijiet
  7. Eżerċizzju prattiku
  8. Punti Ewlenin

L-ewwel talba tiegħek

L-endpoint POST /v1/responses huwa l-punt tad-dħul prinċipali għall-API tar-Risposti. Hawnhekk tibgħat il-prompts tiegħek u tirċievi tweġibiet mill-mudelli Grok. F’din il-lezzjoni, se titgħallem kif tibni u tibgħat l-ewwel talba tiegħek.

Awtentikazzjoni

It-talbiet kollha jeħtieġu header ta’ awtentikazzjoni bil-key tal-API ta’ xAI tiegħek:

Authorization: Bearer $XAI_API_KEY

Tista’ tiġġenera l-keys tiegħek fuq console.x.ai. Żommhom sigrieti—qatt tikkommettihom f’repożitorju Git.

Talba minima

Hawnhekk hemm l-aktar talba sempliċi possibbli:

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."
  }'

Żewġ oqsma huma biżżejjed:

  • model: l-ID tal-mudell Grok li għandu jintuża
  • input: il-prompt tiegħek, bħala test sempliċi

Mas-SDK tal-Python

Jekk tuża l-OpenAI SDK (kompatibbli ma’ xAI), is-sintassi hija simili:

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)

Input sempliċi vs strutturat

Il-parametru input jaċċetta żewġ formati.

Test sempliċi

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?"
}

Array strutturat

Għal inputs multimodali jew rwoli espliċiti:

{
  "model": "grok-4.20-0309-reasoning",
  "input": [
    {
      "role": "user",
      "content": "Analyze this image and describe what you see."
    }
  ]
}

Il-format tal-array jagħtik aktar kontroll, speċjalment biex tinkludi stampi jew tispeċifika rwoli differenti.

Il-parametru tal-istruzzjonijiet

Biex tagħti lill-mudell imġiba tas-sistema, uża instructions minflok ma żżid messaġġ tas-sistema f’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?"
}

Il-qasam instructions huwa ekwivalenti għas-system prompt fil-Chat Completions. Jiddefinixxi l-imġiba ġenerali tal-mudell għaċ-ċaħda kollha.

Eżerċizzju prattiku

Ipprova tibni talba li:

  1. Tuża l-mudell grok-4.20-0309-reasoning
  2. Tiddefinixxi istruzzjonijiet tas-sistema għal assistent tekniku
  3. Tagħmel mistoqsija dwar il-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?"
  }'

Punti Ewlenin

  • POST /v1/responses huwa l-endpoint prinċipali—jeħtieġ model u input
  • input jaċċetta test sempliċi jew array strutturat bir-rwoli
  • instructions jiddefinixxi l-imġiba tas-sistema tal-mudell
  • L-awtentikazzjoni ssir permezz tal-header Authorization: Bearer
  • L-OpenAI SDK huwa kompatibbli ma’ xAI billi tbiddel il-base_url