Govornik API

Enostavno pretvorite besedilo v govor – brez grafičnega vmesnika, z možnostjo integracije v lastne aplikacije.

📌 Kako začeti?

API lahko uporabljate le, če izpolnite spodnji obrazec z imenom projekta in vašim e-poštnim naslovom. Pošiljanje podatkov je možno z metodo GET ali POST.

📝 Prijava vašega projekta

Če želite API vključiti v svoj projekt, vas prosim, da vnesete svoj e-poštni naslov in ime projekta. Podatki bodo uporabljeni izključno za obveščanje o morebitnih spremembah ali motnjah v delovanju.

🔄 Spremembe

Pred uporabo preverite najnovejše spremembe v Govorniku (spremembe se nanašajo tako na API, aplikacije in strežnik).

🔗 Povezave

• https://s1.govornik.eu – Glavni strežnik s HTTPS podporo
• http://s1.govornik.eu – Glavni strežnik (HTTP)
• http://s2.govornik.eu – Rezervni strežnik (trenutno še ni dosegljiv)

API lahko uporabljate brez registracije ali uporabniškega imena. Uporaba je brezplačna, priporočamo pa, da v aplikaciji navedete, da uporabljate Govornik. Pošiljanje podatkov je možno z metodo GET ali POST.

📥 Parametri API-ja

text (obvezno)

Besedilo, ki ga želite pretvoriti v govor. Lahko vsebuje poljubne stavke v slovenščini.

voice (obvezno)

Ime glasu, ki bo uporabljen pri sintezi. Celoten seznam glasov je vedno na voljo na URL poti /voices.

Glasovi, ki so na voljo:

• nik2023
• nik-unit
• nik-hmm-hsmm
• marko
• lili
• lars

version (opcijsko)

Izbira različice govorne sinteze. Če ni navedeno, se uporabi različica 2.

• 1 – osnovna sinteza brez podpore datumov in vrstilnih števnikov
• 2 – prepozna vrstilne števnike in datume
• 3 – podpira fonetične popravke z uporabo SAMPA

source (obvezno)

Identifikator vašega projekta ali aplikacije. Pomaga vzdrževati statistiko in stabilnost. Uporabljajte stalno ime brez testnih oznak.

format (opcijsko)

Format izhodnega posnetka. Privzeto wav. Možni vrednosti sta:

• mp3 – stisnjeno, primernejše za splet
• wav – višja kakovost, brez kompresije

🧪 Primeri uporabe

Spodaj so predstavljeni primeri uporabe Govornik API.

✅ GET primer

https://s1.govornik.eu/?voice=lars&text=Pozdravljen+na+ta+prekrasen+dan.&source=APIwebsite&version=2

✅ POST primer (cURL)

curl -X POST https://s1.govornik.eu/ \
  -d "voice=lili" \
  -d "text=Kupil sem 102. avto." \
  -d "source=APIwebsite" \
  -d "version=2" \
  --output output.mp3

✅ Primer z verzijo 3 in SAMPA

https://s1.govornik.eu/?voice=nik2023&text=Zdravo+Matjaž+[no:va:k]!&source=APIwebsite&version=3&format=mp3

✅ Pridobitev seznama glasov

https://s1.govornik.eu/voices

Odgovor:

nik2023 sl male unitselection general
nik-unit sl male unitselection general
nik-hmm-hsmm sl male hmm
marko sl male unitselection general
lili sl female unitselection general
lars sl male unitselection general

❗ Napake pri pošiljanju zahtev

Spodaj so našteti HTTP statusi, ki se lahko zgodijo pri uporabi storitve.

200

Zahteva je bila uspešno izvedena.

400

Poslani parametri niso bili pravilni. Preverite, ali ste poslali vse zahtevane parametre.

405

Na strežnik ste poslali zahtevo z metodo, ki ni podprta. Dovoljeni sta le GET in POST.

500

Na strežniku se je zgodila napaka. Ponovno pošljite zahtevo čez nekaj trenutkov.

418

Zahtevan URL ne obstaja. Preverite poslano zahtevo.

✅ Odgovori API

API ob vsaki zahtevi vrne posnetek ali opis napake.

ℹ️ Dodatne informacije

API je v razvoju – lahko ga preizkusite, uporabljate v projektih ali celo gostite lokalno (v dogovoru). Za več informacij pišite na info@govornik.eu.