Dokumentacja API

Dla programistów

Twórz z przyjemnością, korzystając z głosów Voiser.net.

?

VOISER LIMITLESS MP3 API — wysyłając teksty metodą POST w formacie JSON z własnego projektu, otrzymujesz plik audio MP3 wraz z informacjami o nim.

OGÓLNA CHARAKTERYSTYKA API

OPIS	ZAWARTOŚĆ
Adres żądania POST	https://voiser.net/api/limitless/
Metoda żądania	POST
Format danych żądania	JSON
Kodowanie znaków	UTF-8
Limit jednego żądania	Maks. 3000 znaków
Format wyjściowy	MP3
Utworzony plik audio	MP3

PARAMETRY WEJŚCIOWE API

PARAMETR	OPIS
authCode	Twój kod użytkownika (STRING)
articleText	Tekst do udźwiękowienia, bez znaczników (STRING)
configVoice	Kod głosu (STRING)
configLang	Kod języka (STRING)
configPitch	Wysokość głosu (dla zwykłego czytania 0; min. -20.00, maks. 20.00, INT)
configSpeed	Tempo czytania (dla zwykłego czytania 1; min. 0.3, maks. 4.0, INT)

PARAMETRY WYJŚCIOWE API

PARAMETR	OPIS
status	Status operacji (success\|error)
processTime	Czas przetwarzania nagrania
barkod	Kod kreskowy nagrania
counter	Pozostałe znaki na Twoim koncie
fileUrl	Adres URL pliku audio
createTime	Data i godzina utworzenia nagrania

KODY JĘZYKÓW

NAZWA JĘZYKA	KOD
Turecki	tr-TR
Angielski (Wielka Brytania)	en-GB
Angielski (USA)	en-US
Arabski	ar-XA
Niemiecki	de-De
Chiński	cmn-CN
Francuski	fr-FR
Włoski	it-IT
Japoński	ja-JP
Koreański	ko-KR
Rosyjski	ru-RU

KODY GŁOSÓW

KİŞİ	KOD GŁOSU	KOD JĘZYKA
Hakan	E	tr-TR
Aylin	D	tr-TR
Berk	B	tr-TR
Melis	C	tr-TR
Daisy	C	en-GB
Tom	D	en-GB
Harry	B	en-GB
Joseph	B	en-US
Emma	C	en-US
Jacob	D	en-US
Olivia	E	en-US
Emily	F	en-US
Emma	A	de-De
Noah	B	de-De
Hanna	C	de-De
Elias	D	de-De
王芳	A	cmn-CN
王伟	B	cmn-CN
张伟	C	cmn-CN
Clara	A	fr-FR
Louise	B	fr-FR
Camille	C	fr-FR
Raphaël	D	fr-FR
Alessia	A	it-IT
Teodora	B	it-IT
Giuseppe	C	it-IT
Giovanni	D	it-IT
莉子	A	ja-JP
咲良	B	ja-JP
陽翔	C	ja-JP
湊	D	ja-JP
아현	A	ko-KR
지유	B	ko-KR
도윤	C	ko-KR
유준	D	ko-KR
Sasza	A	ru-RU
Władimir	B	ru-RU
Alina	C	ru-RU
Dmitrij	D	ru-RU
مصطفى	B	ar-XA
وليد	C	ar-XA
مريم	A	ar-XA

PRZYKŁADOWY PLIK WEJŚCIOWY (WYSYŁANY JSON)


        {
            "authCode" : "1234567890",
            "articleText" : "Bu bir deneme metindir.",
            "configVoice" : "E",
            "configLang" : "tr-TR",
            "configPitch" : "0",
            "configSpeed" : "1"
        }

PRZYKŁADOWY PLIK WYJŚCIOWY (OTRZYMYWANY JSON)


        {
            "status":"success",
            "processTime":23.079911947250366,
            "barkod":"ZRRI",
            "counter":79972,
            "fileUrl":"https:\/\/www.voiser.net\/api\/render\/2020_10_01_10_40_52_GIF7.mp3",
            "durationSeconds":573,
            "durationFormat":"00:09:33",
            "createTime":"2020-10-01 10:40:53"
        }

W sprawach technicznych i po informacje bilgi@voiser.net możesz skontaktować się z nami mailowo.

Pełny przykład użycia:


        <script>
            var authCode = "**twój kod użytkownika**";
            var playerPositionX = "right";
            var playerPositionY = "bottom";
            var readingLanguage = "pl";
            var readingDivId = "Page-Text-Id";
            var playerBgColor = "#04a4e2";
        </script>
        <script src="https://voiser.net/api/web3/speak.js"></script>

Skrypt ze zmiennymi i stroną żądania.

Tutaj można zmieniać zmienne. Wartości domyślne dobrano tak, aby wygląd był najlepszy. Jeśli konfiguracja odtwarzacza pozostanie niezmieniona, wyświetli się on w wersji standardowej.

Te ustawienia, ich opisy i wartości domyślne:

ZMIENNA	OPIS	WARTOŚCI
playerPositionX	Położenie odtwarzacza w osi x	right, left
playerPositionY	Położenie odtwarzacza w osi y	top, bottom
readingLanguage	Język tekstu i lektora	tr, en
readingDivId	id kontenera div, w którym znajduje się tekst do odczytania	(string)
playerBgColor	Kolor odtwarzacza	(hex color code)

W razie jakichkolwiek problemów lub pytań technicznych możesz zwrócić się do wsparcia technicznego pod adresem bilgi@voiser.net albo przez stronę kontaktu na www.voiser.net.

CO TO JEST?

VOISER STREAM API — wysyłając teksty na adres URL metodą GET z własnego projektu, otrzymujesz plik audio od razu w formacie MP3.