API Dökümantasyonu

Geliştiriciler İçin

Voiser.net sesleri ile alanınızda geliştirmenin keyfine varın.

Nedir?

VOISER LIMITLESS MP3 API ile Kendi projeniz üzerinden JSON formatında metinlerinizi POST ederek oluşturduğunuz istekleriniz ile MP3 formatında ses dosyası ve beraberinde ses dosyasına ait bilgileri yine JSON formatında elde edebilirsiniz.

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
Çıktı Formatı	MP3
Üretilen Ses Dosyası	MP3

API GİRDİLERİ

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	Ses perdesi (Normal okuma için 0 olmalı, Min. -20.00, Maks. 20.00, INT)
configSpeed	Okuma hızı (Normal okuma için 1 olmalı, Min. 0.3, Maks. 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 limit
fileUrl	Ses dosyasının url adresi
createTime	Sesin oluşturulduğu tarih ve saat

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

ÖRNEK GİRDİ (POST EDİLEN JSON) DOSYASI


        {
            "authCode" : "1234567890",
            "articleText" : "Bu bir deneme metindir.",
            "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"
        }

Teknik konularda destek veya bilgi almak için bilgi@voiser.net e-posta adresi üzerinden bizimle iletişime geçebilirsiniz.

Tam teşekküllü kullanım kodu örneği:


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

Değişkenler ve istek sayfasının bulunduğu kod betiği.

Burada değişkenlere müdahale edilebilir. Varsayılan ayarlar en iyi görünüm için ayarlanmıştır. Oynatıcı konfigürasyonları değiştirilmemesi durumunda varsayılan görünüm ile gelecektir.

Bu konfigürasyonlar, açıklamaları ve varsayılan değerleri ise:

DEĞİŞKEN	AÇIKLAMA	DEĞERLER
playerPositionX	Player’in x eksenindeki konumu	right, left
playerPositionY	Player’in y eksenindeki konumu	top, bottom
readingLanguage	Okunacak metnin ve seslendirmenin yapılacağı dil	tr, en
readingDivId	Okunacak metnin bulunduğu kapsayıcı div tagına ait id	(string)
playerBgColor	Oynatıcının rengi	(hex color code)

Herhangi bir problem ver teknik sorun ile karşılaşılması durumunda bilgi@voiser.net mail adresinden veya www.voiser.net web adresi iletişim sayfasından bize ulaşarak teknik destek alabilirsiniz.

NEDİR?

VOISER STREAM API ile Kendi projeniz üzerinden GET metodu ile URL adresine metinlerinizi POST ederek oluşturduğunuz istekleriniz ile direk MP3 formatında ses dosyası olarak elde edebilirsiniz.