Suiteil an SDK TypeScript de Mistral
Ar an leathanach seo
Cúrsa nuashonraithe an 3 Samhain 2026 tar éis na samplaí a rith leis an SDK
@mistralai/mistralaileagan 3.5.0 agus TypeScript 7.0.2. Níor thiomsaigh an leagan bunaidh. Nuair a ritheann túnpx tscgan TypeScript suiteáilte, íoslódálann sé an pacáistetscnpm atá tréigthe (leagan 2.0.4) in ionad an tiomsaitheora. Bhí an script tástála suite lasmuigh den fhillteánsrca dearadh itsconfig.json. Ní aithnítear an oibiachtprocessach le@types/node. Ar deireadh, diúltaíonn an mód dianmodels.data.lengthagusmodel.idgan bailíochtú roimh ré. Leananntsconfig.jsonanois an cás “tiomsaigh ansin rith le Node.js” ó threoir TypeScript, agus ní liostaítear a thuilleadh Node.js 18 agus 20, a shroich deireadh a saoil, mar leaganacha leordhóthanacha. Foinse: Íoslódáil TypeScript · Roghnaigh roghanna an tiomsaitheora (TypeScript) · Athruithe TypeScript 6.0 · tsx agus TypeScript · Rith-amaí tacaithe ag an SDK · Sceideal scaoileadh Node.js.
Cén fáth an SDK TypeScript a úsáid?
Má bhraitheann do stac ar Node.js, Deno, nó Bun, ligeann SDK TypeScript de Mistral duit samhlacha a chomhtháthú go díreach i d’fheidhmchláir JavaScript agus TypeScript. Seachnaíonn tú sraitheanna idirmheánacha Python nó glaonna HTTP saincheaptha a scríobh. Is é seo an cás is coitianta nuair a chuireann tú AI le feidhmchlár gréasáin atá ann cheana: API Express, backend Next.js, nó oibrí Node ag próiseáil ciú teachtaireachta.
Cuireann clóscríobh statach TypeScript líon sábháilteachta leis a íocann as féin laistigh den chéad uair an chloig d’fhorbairt. Críochnaíonn d’eagarthóir ainmneacha paraiméadair in ionad tú a chur faoi bhrú idir maxTokens agus max_tokens; spreagann earráidí cásaithe nó réimsí cumtha ag am an tiomsaithe, ní ag 3 a.m. sa táirgeadh; agus feictear doiciméadú paraiméadair ar chaitheamh súl gan an comhad a fhágáil. Tá an líon sábháilteachta seo níos tábhachtaí fós toisc gur oibiachtaí neadaithe iad freagraí API ina bhfuil sé furasta leibhéal a chailleadh.
Réamhriachtanais
Díríonn an SDK ar leaganacha LTS Node.js atá á gcothabháil. Ón 3 Samhain 2026, is iad seo leaganacha 22, 24, agus 26; ní fhaigheann Node.js 18 agus 20 paistí slándála a thuilleadh. Seiceáil do leagan le node --version sula dtéann tú ar aghaidh: braitheann an SDK ar mhodúil ES agus ar an API dúchasach fetch. Teastaíonn bainisteoir pacáistí (npm, yarn, nó pnpm) uait freisin, agus eochair API Mistral cruthaithe agus ar fáil mar athróg timpeallachta, mar a cumhdaíodh i gcúrsaí roimhe seo.
Suiteáil
Foilsítear an SDK oifigiúil ar npm mar @mistralai/mistralai:
# Le npm
npm install @mistralai/mistralai
# Le yarn
yarn add @mistralai/mistralai
# Le pnpm
pnpm add @mistralai/mistralai
Cumraíocht TypeScript
Má úsáideann tú TypeScript — rud a mholaimid — suiteáil trí uirlis mar spleáchais forbartha: an tiomsaitheoir, tsx (a ritheann comhaid .ts gan céim tógála), agus @types/node (a chuireann síos ar oibiachtaí Node.js cosúil le process do TypeScript):
npm install -D typescript tsx @types/node
Ná scipeáil an céim seo. Gan TypeScript suiteáilte sa tionscadal, faigheann npx tsc an pacáiste tsc ó npm — tiomsaitheoir oidhreachta tréigthe (2.0.4) — in ionad TypeScript. Ina dhiaidh sin, dearbh an tionscadal mar mhodúil ES, mar a éilíonn doiciméadú TypeScript do chód a thiomsaítear agus a ritheann ansin le Node.js:
npm pkg set type=module
Ar deireadh, cruthaigh tsconfig.json. Úsáideann sé na socruithe a mholann treoir oifigiúil TypeScript don chás seo (module: nodenext). Cumasaíonn sé mód dian freisin, a chiallaíonn go gcaithfidh tú luachanna a d’fhéadfadh a bheith in easnamh i bhfreagraí API a láimhseáil — srian sláintiúil — agus tiomsaíonn sé src/ go dist/:
{
"compilerOptions": {
"target": "esnext",
"module": "nodenext",
"types": ["node"],
"strict": true,
"skipLibCheck": true,
"rootDir": "src",
"outDir": "dist"
},
"include": ["src"]
}
Tá trí líne tuillte ag míniú, mar choscann gach ceann acu earráid a tháinig chun solais agus muid ag tástáil an chúrsa seo:
"types": ["node"]: Lódálann sé cineálacha Node.js. Ó TypeScript 6.0, ní lódáiltear pacáistí@typesgo huathoibríoch a thuilleadh. Gan an líne seo, spreagannprocess.envan earráid “Cannot find name ‘process’”, fiú le@types/nodesuiteáilte."rootDir": "src": Socraíonn sé fréamh foinse do chomhaid thiomsaithe: éiríonnsrc/test-mistral.tsinadist/test-mistral.js. Gan é, tuairiscíonn TypeScript 7 earráid TS5011 nuair nach bhfuil do fhoinsí ag fréamh an tionscadail."skipLibCheck": true: Scipeálann sé seiceáil cineáil ar chomhaid dearbhaithe spleáchais. Is socruithe réamhshocraithe é seo itsconfig.jsona ghintear lenpx tsc --init. Le SDK 3.5.0 agus TypeScript 7, má fhágann tú ar lár é, tarlaíonn earráid i ndearbhuithe an SDK féin nach féidir le do chód a shocrú.
Foilsítear an SDK mar mhodúil ES agus cuimsíonn sé a chineálacha féin: ní gá aon phacáiste @types/ dó. Mura bhfuil uathchríochnú ag d’eagarthóir, is i do tsconfig.json atá an fhadhb, ní i bpacáiste cineálacha in easnamh.
Athróg Timpeallachta a Chumrú
Ná crua-chódaigh an eochair API i do chód foinse. I Node.js, is é dotenv an réiteach caighdeánach, a lódálann athróga ó chomhad áitiúil ag tús an phróisis:
npm install dotenv
Cruthaigh comhad .env ag fréamh do thionscadail:
MISTRAL_API_KEY=your-api-key-here
Cuir an comhad seo le do .gitignore láithreach, sula ndéanann tú do chéad ghealltanas. Seo an t-am cruinn a sceiteann eochracha:
.env
.env.local
Caithfidh an t-allmhairiú dotenv/config teacht roimh aon léamh ar process.env. Murach sin, fanfaidh an athróg neamhshainithe nuair a chruthaíonn tú an cliant:
import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';
const client = new Mistral({
apiKey: process.env.MISTRAL_API_KEY,
});
An Suiteáil a Fhíorú
Sula scríobhann tú loighic gnó, bailíochtaigh an slabhra iomlán — suiteáil, eochair, líonra — le script íosta. Cruthaigh src/test-mistral.ts agus iarr go simplí ar an liosta samhlacha atá inrochtana ag do chuntas:
import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';
async function main() {
const client = new Mistral({
apiKey: process.env.MISTRAL_API_KEY,
});
// Liostaigh na samhlacha atá ar fáil
const models = await client.models.list();
const liste = models.data ?? [];
console.log(`Available models: ${liste.length}`);
for (const model of liste.slice(0, 5)) {
// Marcáiltear cineál samhail nach bhfuil ar eolas ag an leagan SDK seo mar 'UNKNOWN'
if (model.type === 'UNKNOWN') continue;
console.log(` - ${model.id}`);
}
}
main().catch(console.error);
Níl an dá sheiceáil seo maisiúil. Dearbhaíonn an SDK go bhfuil data roghnach, agus is cárta samhail bhunúsach, cárta samhail fine-tuned, nó luach anaithnid (type: 'UNKNOWN') gach iontráil sa liosta. Nuair a chuireann an API cineál samhail nua leis, coinníonn an SDK é sa fhoirm seo in ionad titim amach. Gan an dá thástáil seo, diúltaíonn an mód dian tiomsú.
I bhforbairt, rith é le tsx, a suiteáladh cheana, a thras-chumasaíonn ar an eitilt agus a shábhálann céim tógála duit:
npx tsx src/test-mistral.ts
Rabhadh: Ní sheiceálann tsx cineálacha; baintear iad agus déantar iad a fhorghníomhú. Ní thuairiscíonn tsc ach earráidí clóscríofa. Rith npx tsc --noEmit chun seiceáil gan tiomsú. Chun tiomsú agus ansin rith, mar a dhéanfaidh do phíblíne tógála:
npx tsc && node dist/test-mistral.js
Taispeánann eochair bailí líon na samhlacha agus na chéad chúig iontráil. Taispeánann eochair diúltaithe earráid Status 401 (Invalid API Key): oibríonn an slabhra, níl locht ach ar an eochair.
An Tionscadal a Eagrú
Nuair a éiríonn leis an bhfíorú, struchtúraigh an tionscadal ionas nach scaipeann an eochair agus an cliant ar fud comhad:
mon-projet/
├── src/
│ ├── index.ts # Pointe iontrála
│ ├── mistral-client.ts # Túsú an chliaint (singilteán)
│ └── utils/
├── .env # Athróga timpeallachta (git-ignored)
├── .gitignore
├── package.json
└── tsconfig.json
Seachnaíonn lárnú túsaithe an chliaint i modúl tiomanta é a athchruthú i ngach comhad. Níos tábhachtaí fós, cúisíonn sé leis an bhfeidhmchlár teipthe ag am tosaithe seachas ag an gcéad ghla ó úsáideoir má tá an eochair in easnamh:
// src/mistral-client.ts
import { Mistral } from '@mistralai/mistralai';
if (!process.env.MISTRAL_API_KEY) {
throw new Error('The MISTRAL_API_KEY variable is required.');
}
export const mistral = new Mistral({
apiKey: process.env.MISTRAL_API_KEY,
});
Ní dhéanann an chuid eile den chód ach an cliant réamhdhéanta seo a allmhairiú:
// src/index.ts
import 'dotenv/config';
import { mistral } from './mistral-client.js';
Tabhair faoi deara an leathnú .js san allmhairiú coibhneasta. Le module: nodenext, éilíonn TypeScript an t-ainm comhaid mar a bheidh sé tar éis tiomsaithe, agus tá a fhios ag tsx é a mhapáil don chomhad .ts. Tá tábhacht le hord allmhairithe freisin: forghníomhaíonn dotenv/config roimh mistral-client.js, mar sin lódáiltear an eochair nuair a sheiceálann an modúl sin a láithreacht.
Príomhphointí
- Suiteáil an SDK TypeScript le
npm install @mistralai/mistralai - Is é an príomh-allmhairiú ná
import { Mistral } from '@mistralai/mistralai' - Suiteáil
typescript,tsx, agus@types/nodemar spleáchais forbartha sula nglaoíonn tú arnpx tsc - Úsáid
module: nodenextagus"type": "module"do chód a thiomsaítear agus a ritheann ansin le Node.js; glacann allmhairithe coibhneasta an leathnú.js - Úsáid comhad
.envledotenvchun an eochair API a bhainistiú - Soláthraíonn an SDK cineálacha dúchasacha TypeScript: bain leas as uathchríochnú, agus lig do
tscseiceáil a dhéanamh ar na rudaí a scipeálanntsx - Lárnigh túsú an chliaint i modúl tiomanta