Govornik API

Govornik API je orodje za programerje. Omogoča pretvarjanje vhodnega besedila v govor brez grafičnega vmesnika. Kot rezultat vrne posnetek v formatu WAV/MP3.

Kako ga uporabiti?

Za uporabo ne potrebujete uporabniškega imena. Uporaba je brezplačna. Zaželjeno je le, da nekje v svoji aplikaciji omenite, da uporabljate program Govornik. Podatke API-ju lahko pošiljate preko POST ali GET metode.


Če nameravate API uporabiti v svojem projektu, vas lepo prosim, če v spodnje okno vpišete svoj e-poštni naslov in ime projekta (source parameter).
Uporabljen bo izključno in samo za obveščanje o delovanju API programa in o morebitnih spremembah. Ko bo ime projekta omogočeno, boste dobili povratno informacijo.


Spremembe v Govorniku

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

Osnovni podatki o API

Povezave do API

Do API lahko dostopate preko spodnjih povezav:

  • https://s1.govornik.eu - Glavni stežnik. Uporabite ga za vse zahteve. Tega uporabite predvsem takrat, kadar želite zagotoviti varno povezavo.
  • http://s1.govornik.eu - Glavni strežnik. Uporabite ga za vse zahteve.
  • http://s2.govornik.eu - Varnostni strežnik. Uporabite ga, če glavni strežnik ne deluje. (Izvajanje zahtev lahko traja nekoliko dlje).

Spremenljivke

text

Obvezno. Ta spremenljivka pove, katero besedilo želite pretvoriti.

Primer: text=Pozdravljen.

voice

Obvezno. Ta spremenljivka pove, kater glas želite uporabiti.

Izbirate lahko med:

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

Seznam glasov, ki so trenutno dostopni dobite kot odgovor na strani s1.govornik.eu/voices.

Primer: voice=nik-unit

version

Opcijsko. Ta spremenljivka pove, kateri tip pretvornika želite uporabiti. Prevzeto 2.

  • V1 -> Števila pretvori v glavne števnike, datumi se ne berejo.
  • V2 -> Števila se pretvori tudi v vrstilne števnike, datume prebere v osnovni obliki, je tip, ki se stalno posodablja in izboljšuje.
  • V3 -> Omogoča uporabo SAMPA besed v besedilu. Če imate besedilo in v njem Govornik nepravilno naglasi besedo, jo sedaj lahko enostavno popravite tako, da mu podate besedo v SAMPA obliki. Več o tem tukaj.

Primer: version=2

source

Obvezno. Ta spremenljivka pove, od kod prihaja zahteva. Izberite si takšno ime, ki opisuje vaš projekt. To ime pa potem tudi dosledno uporabljajte čez vaš celoten projekt. NE uporabljajte testnih imen, kot so "apitest", "apiwebsite" ipd. Zahteve s tem podatkom bodo preklicane.

Primer: source=APItestSite

format

Opcijsko. Ta spremenljivka pove, v kakšnem formatu želite posnetek. Na voljo sta dva formata:

  • wav
  • mp3

Če uporabite mp3 format bo procesiranje trajalo nekaj trenutkov dlje, saj je potrebno posnetek pretvoriti iz WAV formata v MP3.

Primer: format=wav

Napake

HTTP 200

Zahteva je bila uspešno izvedena.

HTTP 400

Parametri niso bili pravilni. Preverite, če ste poslali vse zahtevane parametre. Če uporabljate V3 potem bo telo odgovora vsebovalo napako, ki se je zgodila (Napaka v SAMPA besedi).

HTTP 405

Podprti sta metodi GET in POST. Preverite, da uporabljate pravilno metodo.

HTTP 500

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

HTTP 418

Poslan URL ne obstaja. Preverite, da vse zahteve za sintezo pošiljate na pravilen url.

Odgovor API

API ob vsaki zahtevi vrne nekakšen odgovor (razen v primeru nedelujočega strežnika). Vrne pa lahko:

  • WAW/MP3 posnetek
  • Navadno besedilo

    Primeri uporabe pošiljanja ukazov API

    Primer 1

    Link: http://s1.govornik.eu

    GET spremenljivke:

    • voice=nik-unit
    • text=Pozdravljen na ta prekrasen dan.
    • source=APIwebsite
    • version=1

    Odgovor

    Opis

    Zgornji primer bo vhodno besedilo pretvoril z glasom »nik-unit« z uporabo tipa 1.

    Primer 2

    Link: http://s1.govornik.eu

    POST spremenljivke:

    • voice= nik-hmm-hsmm
    • text=Kupil sem 102. avto.
    • source=APIwebsite
    • version=2

    Odgovor

    Opis

    Zgornji primer bo vhodno besedilo pretvoril z glasom »nik-hmm-hsmm« z uporabo tipa 2. Kar pomeni, da bo ta stavek prebral pravilno. Če bi uporabili tip 1 bi bil stavek prebran napačno (napravilno prebran števnik).

    Primer 3

    Link: https://s1.govornik.eu/voices

    Odgovor

    nik-unit sl male unitselection general

    nik-hmm-hsmm sl male hmm

    marko sl male unitselection general

    Opis

    Zgornji primer bo kot odgovor v tekstovni obliki vrnil vse glasove, ki so na voljo. Ko izpolnjujete zahtevo, uporabite samo prvo besedo v vsaki vrstici. Torej:

    • nik-unit
    • nik-hmm-hsmm
    • marko

    Primer 4

    Link: http://s1.govornik.eu

    GET spremenljivke:

    • text=Kupil sem 102. avto.

    Odgovor

    HTTP 400 Parameters are incorrect

    Opis

    Zgornji primer bo vrnil napako, saj niso bili podani pravilni parametri.

    Primer 5

    Link: http://s1.govornik.eu

    GET spremenljivke:

    • voice= nik-unit
    • text=Kupil sem nov avto.
    • source=APIwebsite
    • version=2
    • format=mp3

    Odgovor

    Opis

    Zgornji primer bo vhodno besedilo pretvoril z glasom »nik-unit« z uporabo tipa 2. Prav tako pa ne bo vrnil posnetka v WAV formatu ampak MP3.

    Primer 6

    Link: http://s1.govornik.eu

    GET spremenljivke:

    • voice= nik-unit
    • text=Zdravo Matjaž [no:va:k]!
    • source=APIwebsite
    • version=3
    • format=mp3

    Odgovor

    Opis

    Zgornji primer bo vhodno besedilo pretvoril z glasom »nik-unit« z uporabo tipa 3. Prav tako pa ne bo vrnil posnetka v WAV formatu ampak MP3.

    Omejitve

    API je v fazi razvoja, zato ne pričakujte odlične kvalitete, pravilno prebranih vseh besedil, velike hitrosti. Govornik API pa lahko tudi uporabite lokalno na svojem strežniku. Program za to še ni javno na voljo. Če pa bi želeli preizkusiti delovanje pa pišite na spodnji mail.

    Več informacij

    Če potrebujete več informacij, odgovore na vprašanja, lahko pišete na e-mail info (at) govornik . eu.