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

Do Chéad Ghlaó Trascairibhthe

Ceacht 5 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do chéad thrascairibhthú le Voxtral
  2. An timpeallacht a ullmhú
  3. Comhad áitiúil a thrascairibhthú
  4. Trascairibhthú ó URL
  5. Bogadh chuig leagan láidir
  6. Cad atá sa fhreagairt
  7. Príomhphointí

An cúrsa nuashonraithe an 3 Samhain, 2026 le haghaidh Voxtral 3, bunaithe ar threoir Migrate from Voxtral 2 ó Mistral: tá samhlacha Voxtral 2 (voxtral-mini-2602, voxtral-mini-transcribe-realtime-2602, voxtral-mini-tts-2603), a dí-chódaíodh an 31 Deireadh Fómhair, 2026 agus a baineadh an 30 Aibreán, 2027, curtha in ionad sna samplaí ag voxtral-mini-transcribe-3, voxtral-mini-transcribe-realtime-3, agus voxtral-mini-tts-3-0. Príomhathruithe: níl stampaí ama ach ar leibhéal na míreanna (tabharfaidh word earráid 400), tá dé-aitheantas (diarization) indéanta i bhfíor-am, tá socruithe seisiúin fíor-ama glasáilte tar éis an chéad smután fuaime, agus tá ionchuir context_bias saorchruthach (frásaí le spásanna). Foinse: Migrate from Voxtral 2(https://docs.mistral.ai/studio/audio/migrate-from-voxtral-2) · Speech to Text.

Do chéad thrascairibhthú le Voxtral

Go leor teoirice. Sa cheacht seo, déanfaidh tú do chéad ghlaó iomlán chuig an API trascairibhthe as líne: téann comhad fuaime áitiúil go Voxtral Mini Transcribe 3, agus próiseálann tú an téacs a fhilltear. Oireann an cód do chúpla líne, ach ansin déanfaimid leagan láidir de atá oiriúnach d’oibriú gan faire.

An timpeallacht a ullmhú

Suiteáiltear SDK Mistral le haon ordú amháin. Sábhálfaidh an céim fíoraithe a leanas tú ó bheith ag lorg earráide allmhairithe níos déanaí.

# Suiteáil SDK Mistral
pip install mistralai

# Fíoraigh an tsuiteáil
python -c "from mistralai.client import Mistral; print('SDK installed')"

Beidh eochair API Mistral uait. Cruthaigh ceann ag console.mistral.ai agus stóráil i athróg timpeallachta é seachas é a chódú go crua:

export MISTRAL_API_KEY="your-api-key-here"

Comhad áitiúil a thrascairibhthú

Seo an cód iomlán chun comhad fuaime áitiúil a thrascairibhthú:

import os
from mistralai.client import Mistral

# Tosaigh an cliant
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Oscail agus trascairibhthigh an comhad fuaime
with open("mon_audio.mp3", "rb") as f:
    response = client.audio.transcriptions.complete(
        model="voxtral-mini-transcribe-3",
        file={"content": f, "file_name": "mon_audio.mp3"}
    )

# Taispeáin an toradh
print("=== Transcription ===")
print(response.text)

Sin é. I gceithre líne de chód gníomhach, faigheann tú trascairibhthú iomlán do chomhaid fuaime.

Déanaimis siúlóid trí na ceithre líne seo. Cruthaíonn Mistral(api_key=...) an cliant le do eochair API; is é seo an oibiacht a úsáidfidh tú arís do gach glaó ina dhiaidh sin. Osclaíonn open("mon_audio.mp3", "rb") an comhad i mód dénártha, rud atá éigeantach d’fhuaime—má fhágann tú an b ar lár, tarlóidh earráid díchódaithe atá deacair a léirmhíniú. Iarrann an paraiméadar file={"content": f, "file_name": "..."} foclóir ina bhfuil an oibiacht chomhaid agus a ainm; níl an t-ainm seo maisiúil, cabhraíonn sé leis an bhfreastalaí an formáid a bhrath. Ar deireadh, tá an trascairibhthú iomlán mar shreang in response.text.

Trascairibhthú ó URL

Má tá do chomhad fuaime óstáilte ar líne cheana féin, úsáid file_url in ionad file:

import os
from mistralai.client import Mistral

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

response = client.audio.transcriptions.complete(
    model="voxtral-mini-transcribe-3",
    file_url="https://example.com/mon_audio.mp3"
)

print(response.text)

Caithfidh an URL a bheith inrochtana go poiblí. Íoslódálfaidh freastalaí Mistral an comhad go díreach, rud a sheachnaíonn an fhuaim a ródú trí do mheaisín nuair atá sé sa scamall cheana féin—sábháil shuntasach bandaleithid do chatalóg de roinnt céad comhad.

Bogadh chuig leagan láidir

Oibríonn an script íosta le haghaidh tástála. I dtáirgeadh, ní mór duit déileáil le comhaid in easnamh, formáidí gan choinne, eochracha in easnamh, agus earráidí líonra. Déanann an script seo a leanas na seiceálacha seo roimh an nglaó, agus ansin sábhálann sé an toradh.

import os
import sys
from pathlib import Path
from mistralai.client import Mistral

def transcrire_audio(chemin_fichier: str) -> str:
    """Trascairibhthíonn sé comhad fuaime le Voxtral Mini Transcribe 3."""

    # Seiceáil go bhfuil an comhad ann
    fichier = Path(chemin_fichier)
    if not fichier.exists():
        raise FileNotFoundError(f"Fichier introuvable : {chemin_fichier}")

    # Seiceáil an leathnú
    extensions_valides = {".mp3", ".wav", ".flac", ".ogg", ".m4a", ".webm"}
    if fichier.suffix.lower() not in extensions_valides:
        raise ValueError(
            f"Format non supporté : {fichier.suffix}. "
            f"Formats valides : {', '.join(extensions_valides)}"
        )

    # Seiceáil méid (teorainn phraiticiúil: ~200 MB)
    taille_mo = fichier.stat().st_size / (1024 * 1024)
    if taille_mo > 200:
        print(f"Attention : fichier volumineux ({taille_mo:.1f} Mo)")

    # Tosaigh an cliant
    api_key = os.environ.get("MISTRAL_API_KEY")
    if not api_key:
        raise EnvironmentError("Variable MISTRAL_API_KEY non définie")

    client = Mistral(api_key=api_key)

    # Trascairibhthigh
    try:
        with open(chemin_fichier, "rb") as f:
            response = client.audio.transcriptions.complete(
                model="voxtral-mini-transcribe-3",
                file={"content": f, "file_name": fichier.name}
            )
        return response.text
    except Exception as e:
        raise RuntimeError(f"Erreur de transcription : {e}")

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Usage : python transcrire.py <fichier_audio>")
        sys.exit(1)

    chemin = sys.argv[1]
    print(f"Transcription de : {chemin}")
    print("-" * 50)

    texte = transcrire_audio(chemin)
    print(texte)

    # Sábháil i gcomhad téacs
    sortie = Path(chemin).stem + "_transcription.txt"
    Path(sortie).write_text(texte, encoding="utf-8")
    print(f"\nTranscription sauvegardée dans : {sortie}")

Rith é ón teirminéal trí chonair an chomhaid a rith:

python transcribe.py meeting_march15.mp3

Seiceálann an script an comhad, déanann sé trascairibhthú air, taispeánann sé an toradh, agus sábhálann sé go huathoibríoch é i gcomhad .txt leis an mbunainm céanna. Anois tá an creatlach agat le haghaidh próiseála baisce: déan lúbadh thar fhillteán, agus déanfaidh do chartlann fuaime a cartlann téacs inchuardaigh de.

Cad atá sa fhreagairt

Níl an oibiacht response teoranta do théacs amháin. Soláthraíonn sí fad na fuaime a próiseáladh agus an teanga a d’aithin an tsamhail freisin—dhá tháscaire úsáideacha chun do phoist a logáil agus chun comhaid nach bhfuil sa teanga a bhfuil súil leo a bhrath.

# Téacs iomlán
print(response.text)

# Fad fuaime (i soicindí)
print(f"Durée : {response.duration:.1f}s")

# Teanga bhraththa
print(f"Langue : {response.language}")

Is é an bealach is fearr chun cáilíocht na samhla a thomhas ná í a thástáil ar do ghuth féin. Taifead teachtaireacht gutha a mhaireann tríocha soicind go dtí dhá nóiméad, rith an script thuas, agus déan comparáid focal ar fhocal idir an toradh agus an méid a dúirt tú: feicfidh tú láithreach cá bhfuil na hearráidí annamh, beagnach i gcónaí ar ainmneacha dílse. Ansin déan an cleachtadh arís le comhad i dteanga eile, gan an cód a athrú, chun breathnú ar bhrath uathoibríoch teangacha i ngníomh.

Príomhphointí

  • Teastaíonn 4 líne don ghlaó íosta: cliant, oscailt comhaid, glaó API, léigh an toradh
  • Dhá mhód seolta: comhad áitiúil (file) nó URL (file_url)
  • Cabhraíonn ainm an chomhaid san fhoclóir file le brath formáide
  • I dtáirgeadh, cuir láimhseáil earráidí leis (comhad in easnamh, formáid neamhbhailí, earráid líonra)
  • Tá an trascairibhthú iomlán mar shreang i response.text i gcónaí