API-Dokumentation

Für Entwickler

Viel Spaß beim Entwickeln mit Voiser.net-Stimmen.

?

VOISER LIMITLESS MP3 API können Sie Ihre Texte im JSON-Format aus Ihrem eigenen Projekt per POST senden und erhalten eine MP3-Audiodatei samt Informationen zu dieser Datei, ebenfalls im JSON-Format.

API GENEL ÖZELLİKLERİ

AÇIKLAMA	İÇERİK
Post Url Adresi	https://voiser.net/api/limitless/
İstek Metodu	POST
İstek Veri Formatı	JSON
Kodlama Dili	UTF-8
Tek Seferlik İstek Limiti	Maks. 3000 Karakter
Ausgabeformat	MP3
Üretilen Ses Dosyası	MP3

API-EINGABEN

GİRDİ	AÇIKLAMA
authCode	Kullanıcı kodunuz (STRING)
articleText	Okutmak istediğiniz salt metin (STRING)
configVoice	Ses kodu (STRING)
configLang	Dil kodu (STRING)
configPitch	Tonhöhe (für normales Lesen 0, Min. -20.00, Max. 20.00, INT)
configSpeed	Lesegeschwindigkeit (für normales Lesen 1, Min. 0.3, Max. 4.0, INT)

API ÇIKTILARI

ÇIKTI	AÇIKLAMA
status	İşlem durumu (success\|error)
processTime	Ses oluşumu işlem süresi
barkod	Ses barkodu
counter	Hesabınızda kalan karakter limiti
fileUrl	Ses dosyasının url adresi
createTime	Datum und Uhrzeit der Audioerstellung

DİL KODLARI

DİL ADI	KODU
Türkçe	tr-TR
İngilizce British	en-GB
İngilizce Amerikan	en-US
Arapça	ar-XA
Almanca	de-De
Çince	cmn-CN
Fransızca	fr-FR
İtalyanca	it-IT
Japonca	ja-JP
Korece	ko-KR
Rusça	ru-RU

SES KODLARI

KİŞİ	SES KODU	DİL 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

BEISPIEL-EINGABEDATEI (GEPOSTETES JSON)


        {
            "authCode" : "1234567890",
            "articleText" : "Dies ist ein Testtext.",
            "configVoice" : "E",
            "configLang" : "tr-TR",
            "configPitch" : "0",
            "configSpeed" : "1"
        }

ÖRNEK ÇIKTI (GET EDİLEN JSON) DOSYASI


        {
            "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"
        }

Für technischen Support oder Informationen bilgi@voiser.net e-posta adresi üzerinden bizimle iletişime geçebilirsiniz.

Vollständiges Codebeispiel:


        <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>

Das Skript mit den Variablen und der Anfrageseite.

Die Variablen können hier angepasst werden. Die Standardeinstellungen sind auf das beste Erscheinungsbild ausgelegt. Bleibt die Player-Konfiguration unverändert, wird das Standardaussehen verwendet.

Diese Konfigurationen, ihre Beschreibungen und Standardwerte sind:

VARIABLE	AÇIKLAMA	DEĞERLER
playerPositionX	Player’in x eksenindeki konumu	right, left
playerPositionY	Player’in y eksenindeki konumu	top, bottom
readingLanguage	Die Sprache des vorzulesenden und zu vertonenden Textes	tr, en
readingDivId	Die id des Container-Div, das den vorzulesenden Text enthält	(string)
playerBgColor	Farbe des Players	(hex color code)

Bei Problemen oder technischen Schwierigkeiten erreichen Sie uns unter bilgi@voiser.net oder über die Kontaktseite auf www.voiser.net und erhalten technischen Support.

WAS IST DAS?

VOISER STREAM API können Sie Ihre Texte aus Ihrem eigenen Projekt per GET-Methode an die URL senden und das Ergebnis direkt als MP3-Audiodatei erhalten.