Mistral Azure AI:ssa
Tällä sivulla
Päivitetty 3. marraskuuta 2026: Aiempi TypeScript-esimerkki välitti muuttujat
process.env.AZUREAI_API_KEYjaprocess.env.AZUREAI_ENDPOINTsuoraan funktiolleMistralAzure. Koska molemmat vaihtoehdot ovat pakollisia, TypeScript 7 tiukassa tilassa kieltäytyi kääntämästä koodia (varmistettu versiolla@mistralai/mistralai-azure2.1.0). Ympäristömuuttujat validoidaan nyt ennen asiakasohjelman luomista. Lähde:@mistralai/mistralai-azureSDK.
Miksi käyttää Mistralia Azuren kautta?
Tämä kysymys nousee harvoin teknisistä syistä: suora Mistral API toimii moitteettomasti. Syynä ovat sopimukselliset ja organisaatioon liittyvät seikat. Yritys, joka on jo syvällä Microsoft-ekosysteemissä, hyödyntää neuvoteltua Azure-sitoumustaan, sillä on vakiintuneet hankintaprosessit, eikä se halua avata uutta toimittajasopimusta vain muutaman tuhannen euron arvoisten tokenien vuoksi.
Azure AI:n käyttö konsolidoi laskutuksen olemassa olevaan Azure-sopimukseesi, varmistaa GDPR-vaatimustenmukaisuuden eurooppalaisten alueiden kautta, tarjoaa natiivin integraation muihin Azure-palveluihin – kuten Azure Functions, Cosmos DB ja Azure ML – sekä antaa pääsyn Microsoftin yritystukeen siihen liittyvine palvelutasosopimuksineen. Lyhyesti sanottuna: sama malli, mutta jo IT-osastosi hyväksymän hallintakehyksen sisällä.
Palvelimetön vs. omistettu GPU
Azure tarjoaa kaksi lähestymistapaa, ja valinta riippuu kuormituksen säännöllisyydestä. Maksu käytön mukaan -tila, tunnetaan myös nimellä MaaS (Model as a Service), tarjoaa palvelimetön API:n: GPU-resursseja ei tarvitse varata, maksat vain kulutetuista tokeneista, ja Azure hoitaa skaalautuvuuden automaattisesti. Tämä on suositeltu tila useimpiin käyttötarkoituksiin, erityisesti kun liikenne on epäsäännöllistä tai arvaamatonta.
Reaaliaikaiset päätepisteet (Real-time endpoints) vastaavat päinvastaista tarvetta. Valitset GPU-tyypin ja määrän, infrastruktuuri on omistettu sinulle, ja laskutus tapahtuu laskenta tuntien perusteella – riippumatta siitä, työskenteleekö malli vai onko se jouten. Sisäinen API, jota useat tuhannet käyttäjät kuormittavat jatkuvasti, sopii tähän malliin; prototyyppi, jota käytetään kolme kertaa päivässä, tuhlaa tässä tilassa paljon rahaa. Muista sääntö: tämä tila on suositeltu ennustettaville, suuritehoisille kuormituksille.
Azuressa saatavilla olevat mallit
Mistralin dokumentaatio listaa seuraavat mallit Azuressa (lista haettu 2. marraskuuta 2026). Valikoima kehittyy jatkuvasti: tarkista ajantasainen lista viralliselta sivulta.
| Malli | Sijoittelu |
|---|---|
| Mistral Medium 3.5 | Hyvä suorituskyvyn ja kustannusten suhde |
| Mistral Large 3 (25.12) | Lippulaivamalli vaativiin tehtäviin |
| Mistral Small (25.06) | Nopea ja taloudellinen |
| Codestral (25.01) | Erikoistunut koodin generointiin |
| Ministral 3B (24.10) | Kompakti malli kevyisiin tehtäviin |
| Document AI (OCR 4) | Tekstin ja rakenteen erottelu dokumenteista |
Tunnistetietojen hankkiminen
Tunnistetietojen hakeminen tapahtuu Azure-käyttöliittymän kautta ja vie vain muutaman minuutin:
- Siirry osoitteeseen Microsoft Foundry
- Luo projekti tai valitse olemassa oleva
- Ota käyttöön Mistral-malli malliluettelosta
- Hae päätepisteesi (endpoint) ja API-avaimesi käyttöönotto-sivulta
Sijoita nämä kaksi arvoa ympäristömuuttujiin, aivan kuten suoran Mistral-avaimenkin. Ero on päätepisteessä: jokaisella Azure-käyttöönotolla on oma osoitteensa; yhteistä URL-osoitetta ei ole.
export AZUREAI_ENDPOINT="https://your-endpoint.inference.ai.azure.com"
export AZUREAI_API_KEY="your-azure-secret-key"
Mallin kutsuminen Pythonilla
Mistral SDK tarjoaa erillisen Azure-asiakasohjelman, MistralAzure, joka sisältyy mistralai-pakettiin: syötät sille käyttöönotto-URL-osoitteesi ja avaimesi, ja loput koodista ovat identtisiä suoralle API:lle kirjoitetun kanssa. SDK-version 2.0 (maaliskuu 2026) jälkeen se tuodaan moduulista mistralai.azure.client.
import os
from mistralai.azure.client import MistralAzure
client = MistralAzure(
server_url=os.environ["AZUREAI_ENDPOINT"],
api_key=os.environ["AZUREAI_API_KEY"],
)
response = client.chat.complete(
model="azureai", # Azure-päätepisteiden odottama tunniste
messages=[
{"role": "user", "content": "What are the benefits of sovereign cloud in Europe?"}
]
)
print(response.choices[0].message.content)
Sekavin kohta on parametri model. Odotat kirjoittavasi mistral-large-latest; sen sijaan sinun on syötettävä azureai. Syy on yksinkertainen: malli on jo määritetty Azure-puolella luomassasi käyttöönotossa; päätepiste osoittaa nimenomaan siihen eikä mihinkään muuhun. Mallin vaihtaminen tarkoittaa siis päätepisteen vaihtamista, ei merkkijonon muuttamista koodissa.
Striimaus (streaming) ei kuitenkaan eroa tippaakaan suorasta API:sta – sama metodi, sama .data-taso palan sisällön saavuttamiseksi. Siinä piilee yhtenäisen SDK:n koko pointti: aiemmissa oppitunneissa kirjoittamasi koodi toimii sellaisenaan.
stream = client.chat.stream(
model="azureai",
messages=[
{"role": "user", "content": "Describe the architecture of a data lake on Azure."}
]
)
for chunk in stream:
content = chunk.data.choices[0].delta.content
if content:
print(content, end="", flush=True)
Sama kutsu TypeScriptillä
TypeScript-puolella Azure-asiakasohjelma julkaistaan erillisessä paketissa @mistralai/mistralai-azure, joka asennetaan komennolla npm add @mistralai/mistralai-azure. Sen vaihtoehdot noudattavat JavaScript-käytäntöjä: apiKey ja endpoint, joista molemmat ovat pakollisia. Tästä johtuu ympäristömuuttujien validointi, ilman jota tiukka tila kieltäytyy kääntämästä koodia, sillä ympäristömuuttuja saattaa puuttua:
import { MistralAzure } from '@mistralai/mistralai-azure';
const apiKey = process.env.AZUREAI_API_KEY;
const endpoint = process.env.AZUREAI_ENDPOINT;
if (!apiKey || !endpoint) {
throw new Error('Set AZUREAI_API_KEY and AZUREAI_ENDPOINT.');
}
const client = new MistralAzure({ apiKey, endpoint });
const response = await client.chat.complete({
model: 'azureai',
messages: [
{ role: 'user', content: 'How to secure an Azure Key Vault?' },
],
});
console.log(response.choices[0]?.message?.content);
Lähteet: Mistral Azurella (Mistralin dokumentaatio) · TypeScript SDK
@mistralai/mistralai-azure
Alustan muiden osien hyödyntäminen
Kun kutsu toimii, hyödynnä palveluita, joista jo maksat. Tallenna avaimesi Azure Key Vaultiin ympäristömuuttujien sijaan: kierrätys muuttuu hallinnolliseksi toimeksi, ei uudelleenkäyttöönotoksi. Ota käyttöön diagnostiikkalokit päätepisteessäsi valvoaksesi viivettä ja virheitä; tämä on ainoa tapa erottaa mallin hitaus koodin hitaudesta. Valitse eurooppalainen alue, kuten West Europe tai France Central, pysyäksesi GDPR-vaatimusten mukaisena – tämä on usein juuri syy Azuren valitsemiseen. Lopuksi, määritä Azure Monitor -hälytykset tokenien kulutukselle: huonosti suljettu silmukka yöajossa näkyy laskulla paljon myöhemmin kuin hälytyksessä.
Keskeiset asiat
- Azure AI tarjoaa Mistralin palvelimettömänä (MaaS) tai omistettuna GPU:na
- Malli tunnistetaan API-kutsuissa merkkijonolla
"azureai" MistralAzure-asiakasohjelma vastaanottaa päätepisteen parametrillaserver_url(Python,mistralai.azure.client) taiendpoint(TypeScript,@mistralai/mistralai-azure)- Integrointi Azure-ekosysteemiin (Key Vault, Monitor, Functions) on merkittävä etu yrityksille
- Valitse eurooppalainen alue pysyäksesi GDPR-vaatimusten mukaisena