Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Codestral API Pythonilla

Oppitunti 3 / 14 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Codestralin kutsuminen Pythonilla
  2. Asennus ja konfigurointi
  3. Täydellinen FIM-kutsu
  4. Chat-kutsu koodin generointiin
  5. Edistyneet parametrit
  6. kaksi mallia kopioitavaksi
  7. Virheenkäsittely
  8. Keskeiset asiat

Codestralin kutsuminen Pythonilla

Tässä oppitunnissa siirrytään teoriasta suoritettavaan koodiin. Käytät Mistral AI:n Python-SDK:ta kysyäksesi Codestralilta sen kahdelta päätepisteeltä, säädät edistyneitä parametreja, jotka erottavat hyödyllisen ehdotuksen liian puheliasesta, ja toteutat yleisimmät käytännöt, joita todellisuudessa kohdataan integraatioissa.

Asennus ja konfigurointi

Asenna SDK yhdellä komennolla:

pip install mistralai

Hae API-avaimesi osoitteesta console.mistral.ai ja lue se ympäristömuuttujasta sen sijaan, että koodaisit sen suoraan tiedostoon:

import os
from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Codestralia tarjoaa kaksi alustaa, ja valitset niiden välillä avainta luodessasi. api.mistral.ai toimii maksu käytön mukaan -periaatteella: tämä on standardireitti, kun Codestral on vain yksi osa laajempaa sovellusta. codestral.mistral.ai on omistettu päätepiste, joka on ilmainen tai tilauspohjainen ja suunniteltu kehittäjän suoraa käyttöä varten koodieditorissa.

Täydellinen FIM-kutsu

Tässä on yksityiskohtainen FIM-kutsu kaikilla tärkeillä parametreilla:

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.fim.complete(
    model="codestral-latest",
    prompt="def calculate_vat(price_excl: float, rate: float = 0.20) -> float:",
    suffix="price = float(input('Price excl. VAT: '))\nprint(f'Price incl. VAT: {calculate_vat(price):.2f} EUR')",
    temperature=0,
    max_tokens=150,
    stop=["\n\n"],
)

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

Vastauksen purkaminen

Palautettu objekti sisältää muutakin kuin pelkän generoidun tekstin. Tuotantoympäristössä sinun tulee järjestelmällisesti tarkistaa kolme asiaa: itse täydennys, laskutuksesi määrittävä tokenien kulutus ja pysäytyssyy, joka kertoo, päättyikö malli luonnollisesti vai osuitko raja-arvoon.

# Käytä generoitua täydennystä
text = response.choices[0].message.content

# Tarkista käytettyjen tokenien määrä
tokens_prompt = response.usage.prompt_tokens
tokens_completion = response.usage.completion_tokens
tokens_total = response.usage.total_tokens

# Tarkista pysäytyssyy
reason = response.choices[0].finish_reason  # "stop", "length", jne.

Jos finish_reason on "length" puolessa kutsuistasi, se on selkeä merkki: max_tokens-arvosi on liian pieni, ja toimitat käyttäjillesi typistynyttä koodia.

Chat-kutsu koodin generointiin

Aina kun kohdistin ei ole tiedoston keskellä – kuten koko tiedoston generoinnissa, selityksissä tai refaktoroinnissa – chat-päätepiste ottaa vastuun. Järjestelmäviesti kehystää tällöin tulosteen muodon, mikä poistaa tarpeen siivota vastausta jälkikäteen:

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "system",
            "content": "You are an expert Python development assistant. Respond with code only, no explanations."
        },
        {
            "role": "user",
            "content": "Write a Python function that validates an email address using regex."
        }
    ],
    temperature=0.2,
    max_tokens=500,
)

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

Edistyneet parametrit

min_tokens / max_tokens -pari kehystää tulosteen pituutta. Alaraja on hyödyllinen generoitaessa lohkoa, jonka tiedät olevan vähintään tietyn kokoinen, kuten funktio virheenkäsittelyineen.

# min_tokens: pakottaa vähimmäispituuden
# max_tokens: rajoittaa enimmäispituuden
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    min_tokens=20,
    max_tokens=300,
)

Pysäytystokeneilla on eri rooli: ne pysäyttävät generoinnin tiettyyn kuvioon, pitäen täydennyksen nykyisen funktion rajoissa sen sijaan, että malli jatkaisi ketjutusta seuraavaan funktioon.

# Pysäytä generointi tietyissä kuvioissa
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    stop=["\n\n", "\nclass ", "\ndef "],  # Pysäytä ennen uutta funktiota/luokkaa
)

Lopuksi lämpötila (temperature) hallitsee vaihtelua. Arvolla 0 sama syöte tuottaa aina saman tulosteen, mitä automaattinen täydennys vaatii. Noin arvolla 0.3 malli ehdottaa variaatioita, mikä on kiinnostavaa näytettäessä useita ehdotuksia. Arvolla 0.7 olet koodin ideoinnin tilassa, mikä sopii lähestymistapojen tutkimiseen mutta ei muokkausvirtaan.

# temperature=0: deterministinen (automaattinen täydennys)
# temperature=0.3: hieman luova (useita ehdotuksia)
# temperature=0.7: luova (koodin ideointi)

response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    temperature=0.3,
    top_p=0.95,
)

kaksi mallia kopioitavaksi

Ensimmäinen jäljittelee IDE:n toimintaa: jaat tiedoston sisällön kohdistimen kohdalta, ja kaksi puoliskoa muodostavat prompt- ja suffix-parametrit.

def autocomplete_ide(file_content: str, cursor_position: int) -> str:
    """Simuloi IDE:n automaattista täydennystä Codestral FIM:llä."""
    prompt = file_content[:cursor_position]
    suffix = file_content[cursor_position:]

    response = client.fim.complete(
        model="codestral-latest",
        prompt=prompt,
        suffix=suffix,
        temperature=0,
        max_tokens=100,
        stop=["\n\n", "\ndef ", "\nclass "],
    )

    return response.choices[0].message.content

Toinen automatisoi dokumentaation olemassa olevalle projektille: syötät funktion, haet sen docstringin, ja järjestelmäohje pakottaa yhden muodon, jotta tulos voidaan lisätä ilman lisämuokkausta.

def generate_docstring(function_code: str) -> str:
    """Generoi docstring Python-funktiolle."""
    response = client.chat.complete(
        model="codestral-latest",
        messages=[
            {
                "role": "system",
                "content": "Generate a Google-style docstring for the following function. Return ONLY the docstring between triple quotes."
            },
            {
                "role": "user",
                "content": function_code
            }
        ],
        temperature=0,
        max_tokens=300,
    )
    return response.choices[0].message.content

Virheenkäsittely

Verkkokutsu epäonnistuu ennemmin tai myöhemmin, ja editorilaajennus, joka kaatuu validointivirheeseen, on pahempi kuin laajennus, jossa ei ole täydennystä lainkaan. Kääri siksi kutsusi aina try-except-lohkoon:

from mistralai.client import Mistral
from mistralai.client.errors import HTTPValidationError

try:
    response = client.fim.complete(
        model="codestral-latest",
        prompt=prompt,
        suffix=suffix,
    )
except HTTPValidationError as e:
    print(f"Validation error: {e}")
except Exception as e:
    print(f"Unexpected error: {e}")

Keskeiset asiat

  • mistralai-SDK tarjoaa client.fim.complete() FIM:iä varten ja client.chat.complete() chattiä varten
  • Parametrit prompt ja suffix ovat spesifejä FIM-päätepisteelle
  • Käytä arvoa temperature=0 automaattiseen täydennykseen ja 0.2–0.7 luovaan generointiin
  • stop rajoittaa generoinnin eheään koodilohkoon
  • min_tokens ja max_tokens ohjaavat tulosteen pituutta
  • Käsittele HTTP-virheet aina tuotantokoodissa