Do Chéad Ghlaó Trascairibhthe
Ar an leathanach seo
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í agvoxtral-mini-transcribe-3,voxtral-mini-transcribe-realtime-3, agusvoxtral-mini-tts-3-0. Príomhathruithe: níl stampaí ama ach ar leibhéal na míreanna (tabharfaidhwordearrá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á ionchuircontext_biassaorchruthach (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
filele 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.texti gcónaí