Glaoigh ar an API le cURL
Ar an leathanach seo
An uirlis uilíoch chun APIanna a thástáil
Is uirlis líne na n-orduithe é cURL atá ar fáil ar gach córas oibriúcháin. Ligeann sé duit iarratais HTTP a sheoladh gan SDK a shuiteáil nó clár a scríobh. Is é an uirlis idéalach é chun críochphointe a thástáil go tapa, iarratas a dhífhabhtú, nó glaotha a uathoibriú i script sceall.
Do chéad iarratas cURL
Seo conas iarratas a sheoladh chuig API Grok le cURL:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"messages": [
{"role": "user", "content": "Hello, introduce yourself in one sentence."}
]
}'
An t-ordú a bhriseadh síos
curl https://api.x.ai/v1/chat/completions: seolann sé iarratas POST (tuigthe trí-d) chuig an gcríochphointe-H "Authorization: Bearer $XAI_API_KEY": cuireann sé an ceanntásc fíordheimhniúcháin leis do eochair-H "Content-Type: application/json": deir sé gur JSON é an corp-d '{...}': corp an iarratais i bhformáid JSON
Úsáid an chríochphointe /v1/responses
Tairgeann an críochphointe nua-aimseartha /v1/responses comhcheangal níos giorra:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Explain machine learning to me in simple terms."
}'
Tabhair faoi deara go n-ionadaíonn input do messages i gcás iarratais shimplí. Is féidir leat teaghrán a rith go díreach in ionad eagar teachtaireachtaí.
Roghanna cURL úsáideacha
Formáidiú an aschuir JSON
Tá an freagra amh deacair a léamh. Úsáid jq chun é a fhormáidiú:
curl -s https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Hello"}' | jq .
Folaíonn an rogha -s (ciúin) barra dul chun cinn cURL.
An freagra amháin a bhaint amach
Chun téacs na freagra a fháil gan na meiteashonraí:
curl -s https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"messages": [{"role": "user", "content": "Hello"}]
}' | jq -r '.choices[0].message.content'
Na ceanntásca freagartha a fheiceáil
Chun teorainneacha ráta nó earráidí a dhífhabhtú, cuir -i leis chun na ceanntásca HTTP a thaispeáint:
curl -i https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Test"}'
An corp a léamh ó chomhad
I gcás iarratais chasta, stóráil an JSON i gcomhad:
# request.json
{
"model": "grok-4.5",
"messages": [
{"role": "system", "content": "You are a translator."},
{"role": "user", "content": "Translate into French: Hello world"}
],
"temperature": 0.3
}
Ansin tagairt dó le @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Earráidí coitianta a dhífhabhtú
- 401 Unauthorized: eochair API neamhbhailí nó in easnamh. Seiceáil
echo $XAI_API_KEY - 400 Bad Request: JSON míchumtha. Bailíochtaigh do JSON le
jq . < request.json - 429 Too Many Requests: shroich tú an teorainn ráta. Fan cúpla soicind
- 404 Not Found: seiceáil an URL agus conair an chríochphointe
Príomhphointí
- Tá cURL foirfe chun tástála agus dífhabhtaithe gan cód a scríobh
- Déan fíordheimhniú le
-H "Authorization: Bearer $XAI_API_KEY" - Úsáid
jqchun freagraí JSON a fhormáidiú agus a scagadh - Stóráil iarratais chasta i gcomhaid JSON ar leith