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

Glaoigh ar an API le cURL

Ceacht 8 as 14 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An uirlis uilíoch chun APIanna a thástáil
  2. Do chéad iarratas cURL
  3. Úsáid an chríochphointe /v1/responses
  4. Roghanna cURL úsáideacha
  5. An corp a léamh ó chomhad
  6. Earráidí coitianta a dhífhabhtú
  7. Príomhphointí

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 jq chun freagraí JSON a fhormáidiú agus a scagadh
  • Stóráil iarratais chasta i gcomhaid JSON ar leith