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

An tAicearra /v1/chat/completions

Ceacht 1 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do Gheata chuig Múnlaí Mistral
  2. An Bun-URL
  3. Anatamaíocht Iarratais
  4. Coibhéis Python leis an SDK
  5. Struchtúr na Freagra
  6. Cóid Earráide Coitianta
  7. Príomhphointí

Nuashonrú 2 Samhain 2026 — Múnlaí. Díchódaíodh Mistral Large 3 (mistral-large-2512) agus Mistral Medium 3.5 an 31 Deireadh Fómhair 2026, agus scoirfear de thairiscint iad an 30 Aibreán 2027. Tá an leagan ina n-ionad, Mistral Large 4 (mistral-large-4), ar fáil le haghaidh réamhamhairc poiblí ón 6 Deireadh Fómhair. Úsáideann na samplaí sa chúrsa seo an t-ailias mistral-large-latest, a dhíríonn faoi láthair ar Mistral Large 3 de réir a shonraíochta oifigiúla (fíoraithe 3 Samhain 2026). Ar an gcaoi chéanna, díríonn mistral-medium-latest ar Mistral Medium 3.5. Fanfaidh na hailiasí seo bailí go dtí an 30 Aibreán 2027. Do thionscadail nua, déan tástáil ar mistral-large-4, an leagan ina n-ionad.

Do Gheata chuig Múnlaí Mistral

Téann gach rud a dhéanann tú leis an API Mistral trí bhealach amháin: /v1/chat/completions. Is é seo an mol lárnach den ardán, ag láimhseáil do chuid idirghníomhaíochtaí comhrá go léir le múnlaí teanga. Cibé an bhfuil tú ag tógáil chatbot tacaíochta inmheánaí, eastóscóir a thiontaíonn sonrais PDF ina shraitheanna bunachair sonraí, nó cúntóir scríbhneoireachta comhtháite i do CMS, glaonn na trí fheidhmchlár atá chomh difriúil sin ar an aicearra céanna go díreach le teachtaireachtaí agus paraiméadair éagsúla. Ní gá duit trí chomhtháthú ar leith a fhoghlaim; ní gá duit ach ceann amháin a mháistriú.

Ó Aibreán 2026 i leith, láimhseálann an t-aicearra seo billiúin iarratas in aghaidh an lae ar fud an domhain. Is é tuiscint a fháil ar a struchtúr an chéad chéim chun múnlaí Mistral a úsáid sa táirgeadh.

1 aicearra
Le haghaidh gach comhrá
POST
Modh HTTP amháin
< 500 ms
Moill an chéad token (sruthú)
JSON
Formáid ionchuir/aschuir

An Bun-URL

Tosaíonn gach iarratas chuig API Mistral ón mbun céanna:

https://api.mistral.ai/v1/chat/completions

Seolann tú iarratas POST le corp JSON ina bhfuil do chuid teachtaireachtaí agus paraiméadair, agus filleann an API freagra JSON struchtúrtha. Níl aon seisiúin le hoscailt agus níl aon staid taobh freastalaí le coimeád: tá gach glao féinleor.

Anatamaíocht Iarratais

Is é an bealach is tapúla chun a fhíorú go n-oibríonn do eochair ná iarratas íosta a sheoladh ag baint úsáide as curl go díreach ó do theirminéal:

curl https://api.mistral.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -d '{
    "model": "mistral-large-latest",
    "messages": [
      {"role": "user", "content": "Hello, how does your API work?"}
    ]
  }'

Tá dhá cheanntásc éigeantach: déanann Content-Type: application/json cur síos ar fhormáid chorp an iarratais, agus iompraíonn Authorization: Bearer <do-eochair> do fhíordheimhniú. Caithfidh an corp féin dhá réimse ar a laghad a bheith ann: model, an t-aitheantóir don mhúnla le húsáid, agus messages, an t-eagar a iompraíonn an comhrá.

Coibhéis Python leis an SDK

Nuair a fhágann tú an chéim tástála taobh thiar díot, ní scríobhann aon duine ordaithe curl amh sa táirgeadh. Déanann an SDK oifigiúil an glao céanna i cúpla líne amháin:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "Hello, how does your API work?"}
    ]
)

print(response.choices[0].message.content)

Déanann an SDK láimhseáil ar cheanntáscanna, sriailiú JSON, agus parsáil freagra duit. Bainistíonn sé athiarrachtaí uathoibríocha le haghaidh earráidí sealadacha freisin, rud a shábhálann duit ó do chuid loighce athiarrtha féin a scríobh nuair a chruthaíonn buaic thráchta teip thréimhsiúil.

Struchtúr na Freagra

Beag beann ar conas a ghlaonn tú ar an API, filleann sé an oibiacht JSON chéanna i gcónaí:

{
  "id": "cmpl-abc123",
  "object": "chat.completion",
  "created": 1712150400,
  "model": "mistral-large-latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! The Mistral API works..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 87,
    "total_tokens": 102
  }
}

Tá trí réimse a thuilleann do haird láithreach. Is é choices eagar ina bhfuil an freagra (nó na freagraí) a ghineadh; is ann a aimsíonn tú an téacs le taispeáint don úsáideoir. Soláthraíonn usage an comhaireamh token don ionchur, don aschur, agus don iomlán, rud a ligeann duit costais réadacha gach gné a rianú seachas an bille a fháil amach ag deireadh na míosa. Ar deireadh, míníonn finish_reason cén fáth ar stop an múnla: stop le haghaidh deireadh nádúrtha, length nuair a ghearr an teorainn token an freagra, nó tool_calls nuair a iarrann an múnla feidhmiú uirlise. Is annamh go mbíonn fadhb mhúnla i gceist le hachoimre a stopann i lár abairte; is é finish_reason de length nár léigh aon duine é.

Cóid Earráide Coitianta

Nuair a théann rud éigin mícheart, filleann an API cóid HTTP caighdeánacha:

  • 400 — Iarratas míchruthaithe (JSON neamhbhailí, paraiméadar in easnamh)
  • 401 — Eochair API neamhbhailí nó in easnamh
  • 429 – Sroicheadh teorainn ráta (an iomarca iarratas)
  • 500 — Earráid freastalaí (déan athiarracht tar éis cúpla soicind)

I bPython, ardaíonn an SDK eisceachtaí típithe is féidir leat a ghabháil, rud a ligeann duit idirdhealú a dhéanamh idir eochair a d’éag agus sáithiú sealadach, agus freagairt go difriúil i ngach cás:

from mistralai.client import Mistral
from mistralai.client.errors import SDKError

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

try:
    response = client.chat.complete(
        model="mistral-large-latest",
        messages=[{"role": "user", "content": "Test"}]
    )
except SDKError as e:
    print(f"API Error: {e.status_code} — {e.message}")

Déan cleachtas de gach glao a chur sa bhloc seo ó do chéad script eile. An lá a ritheann d’iarratas gan faire, inseoidh sé duit cad a theip seachas stopadh go ciúin.

Príomhphointí

  • Is é an t-aicearra /v1/chat/completions an t-aon cheann atá ag teastáil le haghaidh idirghníomhaíochtaí comhrá
  • Éilíonn gach iarratas model agus eagar messages
  • I gcónaí bíonn choices, usage, agus finish_reason sa fhreagra
  • Simplíonn an Python SDK na glaonna go mór i gcomparáid le curl
  • Ligeann token úsáide duit do chostais a ríomh go beacht