API-documentatie

Voor ontwikkelaars

Ontwikkel met plezier met de stemmen van Voiser.net.

?

VOISER LIMITLESS MP3 API — stuur teksten via POST in JSON-formaat vanuit je eigen project en ontvang het MP3-audiobestand met bijbehorende informatie.

ALGEMENE KENMERKEN VAN DE API

OPIS	INHOUD
Adres van het POST-verzoek	https://voiser.net/api/limitless/
Verzoekmethode	POST
Gegevensformaat van het verzoek	JSON
Tekencodering	UTF-8
Limiet per verzoek	Max. 3000 tekens
Uitvoerformaat	MP3
Aangemaakt audiobestand	MP3

INVOERPARAMETERS VAN DE API

PARAMETR	OPIS
authCode	Je gebruikerscode (STRING)
articleText	De in te spreken tekst, zonder opmaakcodes (STRING)
configVoice	Stemcode (STRING)
configLang	Taalcode (STRING)
configPitch	Toonhoogte van de stem (voor normaal lezen 0; min. -20.00, max. 20.00, INT)
configSpeed	Leestempo (voor normaal lezen 1; min. 0.3, max. 4.0, INT)

UITVOERPARAMETERS VAN DE API

PARAMETR	OPIS
status	Status van de bewerking (success\|error)
processTime	Verwerkingstijd van de opname
barkod	Streepjescode van de opname
counter	Resterende tekens op je account
fileUrl	URL van het audiobestand
createTime	Datum en tijd waarop de opname is gemaakt

TAALCODES

TAALNAAM	KOD
Turecki	tr-TR
Engels (Verenigd Koninkrijk)	en-GB
Engels (VS)	en-US
Arabski	ar-XA
Niemiecki	de-De
Chinees	cmn-CN
Francuski	fr-FR
Italiaans	it-IT
Japans	ja-JP
Koreaans	ko-KR
Rosyjski	ru-RU

STEMCODES

KİŞİ	STEMCODE	TAALCODE
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
Vladimir	B	ru-RU
Alina	C	ru-RU
Dmitrij	D	ru-RU
مصطفى	B	ar-XA
وليد	C	ar-XA
مريم	A	ar-XA

VOORBEELD INVOERBESTAND (VERZONDEN JSON)


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

VOORBEELD UITVOERBESTAND (ONTVANGEN 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"
        }

Voor technische zaken en informatie bilgi@voiser.net kun je ons per e-mail bereiken.

Volledig gebruiksvoorbeeld:


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

Script met variabelen en de aanvragende pagina.

Hier kun je de variabelen aanpassen. De standaardwaarden zijn zo gekozen dat de weergave optimaal is. Als de configuratie van de speler ongewijzigd blijft, wordt hij in de standaardversie getoond.

Deze instellingen, hun beschrijvingen en standaardwaarden:

ZMIENNA	OPIS	WAARDEN
playerPositionX	Positie van de speler op de x-as	right, left
playerPositionY	Positie van de speler op de y-as	top, bottom
readingLanguage	Taal van de tekst en de voice-over	tr, en
readingDivId	id van de div-container met de voor te lezen tekst	(string)
playerBgColor	Kleur van de speler	(hex color code)

Bij problemen of technische vragen kun je contact opnemen met onze technische ondersteuning via bilgi@voiser.net of via de contactpagina op www.voiser.net.

WAT IS DIT?

VOISER STREAM API — stuur teksten via GET naar een URL vanuit je eigen project en ontvang het audiobestand direct in MP3-formaat.