とは?
VOISER LIMITLESS MP3 API ご自身のプロジェクトから JSON 形式でテキストを POST すると、MP3 の音声ファイルと、そのファイルに関する情報を JSON 形式で受け取れます。
API の基本仕様
| 説明 |
内容 |
| POST 先の URL |
https://voiser.net/api/limitless/ |
| リクエスト方式 |
POST |
| リクエストのデータ形式 |
JSON |
| 文字エンコーディング |
UTF-8 |
| 1 回のリクエスト上限 |
最大 3000 文字 |
| 出力形式 |
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 |
音声のバーコード |
| counter |
アカウントに残っている文字数の上限 |
| fileUrl |
音声ファイルの URL |
| createTime |
音声が作成された日時 |
言語コード
| 言語名 |
コード |
|
トルコ語
|
tr-TR
|
|
英語(イギリス)
|
en-GB
|
|
英語(アメリカ)
|
en-US
|
|
アラビア語
|
ar-XA
|
|
ドイツ語
|
de-De
|
|
中国語
|
cmn-CN
|
|
フランス語
|
fr-FR
|
|
イタリア語
|
it-IT
|
|
日本語
|
ja-JP
|
|
韓国語
|
ko-KR
|
|
ロシア語
|
ru-RU
|
音声コード
| 声 |
音声コード |
言語コード |
|
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
|
|
Sasha
|
A
|
ru-RU
|
|
Vladimir
|
B
|
ru-RU
|
|
Alina
|
C
|
ru-RU
|
|
Dmitriy
|
D
|
ru-RU
|
|
مصطفى
|
B
|
ar-XA
|
|
وليد
|
C
|
ar-XA
|
|
مريم
|
A
|
ar-XA
|
入力例(POST する JSON)ファイル
{
"authCode" : "1234567890",
"articleText" : "This is a test text.",
"configVoice" : "E",
"configLang" : "tr-TR",
"configPitch" : "0",
"configSpeed" : "1"
}
出力例(GET で取得する 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 = "**ユーザーコード**";
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
|
プレーヤーの x 軸方向の位置
|
right, left
|
|
playerPositionY
|
プレーヤーの y 軸方向の位置
|
top, bottom
|
|
readingLanguage
|
読み上げるテキストの言語
|
tr, en
|
|
readingDivId
|
読み上げるテキストを含む div の id
|
(string)
|
|
playerBgColor
|
プレーヤーの色
|
(hex color code)
|
問題や技術的なご不明点がありましたら、bilgi@voiser.net または www.voiser.net のお問い合わせページからご連絡いただければ、技術サポートをご案内します。
これは何ですか?
VOISER STREAM API ご自身のプロジェクトから GET メソッドで URL にテキストを送ると、結果を MP3 の音声ファイルとして直接受け取れます。
API の基本仕様
| 説明 |
内容 |
| POST 先の URL |
https://voiser.net/api/stream/ |
| リクエスト方式 |
GET |
| リクエストのデータ形式 |
QUERY |
| 文字エンコーディング |
UTF-8 |
| 1 回のリクエスト上限 |
最大 3000 文字 |
| 出力形式 |
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 の出力
| 出力 |
説明 |
| Mp3 |
audio/mpeg, audio/x-mpeg, audio/x-mpeg-3, audio/mpeg3 |
言語コード
| 言語名 |
コード |
|
トルコ語
|
tr-TR
|
|
英語(イギリス)
|
en-GB
|
|
英語(アメリカ)
|
en-US
|
|
アラビア語
|
ar-XA
|
|
ドイツ語
|
de-De
|
|
中国語
|
cmn-CN
|
|
フランス語
|
fr-FR
|
|
イタリア語
|
it-IT
|
|
日本語
|
ja-JP
|
|
韓国語
|
ko-KR
|
|
ロシア語
|
ru-RU
|
音声コード
| 声 |
音声コード |
言語コード |
|
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
|
|
Sasha
|
A
|
ru-RU
|
|
Vladimir
|
B
|
ru-RU
|
|
Alina
|
C
|
ru-RU
|
|
Dmitriy
|
D
|
ru-RU
|
|
مصطفى
|
B
|
ar-XA
|
|
وليد
|
C
|
ar-XA
|
|
مريم
|
A
|
ar-XA
|
入力例
https://voiser.net/api/stream/?authCode=1234567890&articleText=Merhabalar%20bu%20bir%20denemedir&configVoice=E&configLang=tr-TR&configPitch=0&configSpeed=1
出力ファイルの例
MP3 ファイル
技術的なサポートやお問い合わせは bilgi@voiser.net のメールアドレスまでご連絡ください。