Документация API

Для разработчиков

Разрабатывайте с удовольствием, используя голоса Voiser.net.

?

VOISER LIMITLESS MP3 API — отправляя тексты методом POST в формате JSON из собственного проекта, вы получаете аудиофайл в формате MP3 и сведения о нём.

ОБЩИЕ ХАРАКТЕРИСТИКИ API

ОПИСАНИЕ	СОДЕРЖИМОЕ
Адрес POST-запроса	https://voiser.net/api/limitless/
Метод запроса	POST
Формат данных запроса	JSON
Язык кодировки	UTF-8
Лимит одного запроса	Maks. 3000 Karakter
Формат вывода	MP3
Созданный аудиофайл	MP3

ВХОДНЫЕ ПАРАМЕТРЫ API

ПАРАМЕТР	ОПИСАНИЕ
authCode	Ваш пользовательский код (STRING)
articleText	Текст для озвучки, без разметки (STRING)
configVoice	Код голоса (STRING)
configLang	Код языка (STRING)
configPitch	Высота голоса (для обычного чтения 0; мин. -20.00, макс. 20.00, INT)
configSpeed	Скорость чтения (для обычного чтения 1; мин. 0.3, макс. 4.0, INT)

ВЫХОДНЫЕ ПАРАМЕТРЫ API

ПАРАМЕТР	ОПИСАНИЕ
status	Статус операции (success\|error)
processTime	Длительность обработки озвучки
barkod	Ses barkodu
counter	Остаток символов на вашем счёте
fileUrl	URL-адрес аудиофайла
createTime	Дата и время создания записи

КОДЫ ЯЗЫКОВ

НАЗВАНИЕ ЯЗЫКА	KODU
Турецкий	tr-TR
Английский (Великобритания)	en-GB
Английский (США)	en-US
Арабский	ar-XA
Almanca	de-De
Китайский	cmn-CN
Французский	fr-FR
Итальянский	it-IT
Японский	ja-JP
Корейский	ko-KR
Русский	ru-RU

КОДЫ ГОЛОСОВ

KİŞİ	SES KODU	КОД ЯЗЫКА
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
Саша	A	ru-RU
Владимир	B	ru-RU
Алина	C	ru-RU
Дмитрий	D	ru-RU
مصطفى	B	ar-XA
وليد	C	ar-XA
مريم	A	ar-XA

ПРИМЕР ВХОДНОГО ФАЙЛА (ОТПРАВЛЯЕМЫЙ JSON)


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

ПРИМЕР ВЫХОДНОГО ФАЙЛА (ПОЛУЧАЕМЫЙ 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"
        }

По техническим вопросам и за информацией bilgi@voiser.net вы можете связаться с нами по электронной почте.

Полный пример использования:


        <script>
            var authCode = "**kullanıcı kodunuz**";
            var playerPositionX = "right";
            var playerPositionY = "bottom";
            var readingLanguage = "tr";
            var readingDivId = "Page-Text-Id";
            var playerBgColor = "#04a4e2";
        </script>
        <script src="https://voiser.net/api/web3/speak.js"></script>

Скрипт с переменными и страницей запроса.

Здесь можно менять переменные. Значения по умолчанию подобраны для наилучшего вида. Если конфигурацию плеера не менять, он отобразится в стандартном виде.

Эти настройки, их описания и значения по умолчанию:

ПЕРЕМЕННАЯ	ОПИСАНИЕ	ЗНАЧЕНИЯ
playerPositionX	Player’in x eksenindeki konumu	right, left
playerPositionY	Player’in y eksenindeki konumu	top, bottom
readingLanguage	Язык текста и озвучки	tr, en
readingDivId	id контейнера div, в котором находится текст для чтения	(string)
playerBgColor	Цвет плеера	(hex color code)

При возникновении любых проблем или технических вопросов вы можете обратиться в техническую поддержку по адресу bilgi@voiser.net или через страницу контактов на www.voiser.net.

ЧТО ЭТО?

VOISER STREAM API — отправляя тексты на URL-адрес методом GET из собственного проекта, вы получаете аудиофайл сразу в формате MP3.