Oħloq tweġiba b'POST /v1/responses
F'din il-paġna
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żainput: 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:
- Tuża l-mudell
grok-4.20-0309-reasoning - Tiddefinixxi istruzzjonijiet tas-sistema għal assistent tekniku
- 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/responseshuwa l-endpoint prinċipali—jeħtieġmodeluinputinputjaċċetta test sempliċi jew array strutturat bir-rwoliinstructionsjiddefinixxi 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