APIリファレンス
ボイスリスト
TTSで利用可能な音声を取得する
投稿
/api/v1/voices/
認証済みユーザーが Text-to-Speech API で使用を許可されているすべての音声のリストを返します。
認証
Authorizationヘッダーに、`Bearer YOUR_API_KEY`の形式でAPIキーを含めてください。
リクエストボディ
| パラメータ | 必須 | タイプ | 説明 |
|---|---|---|---|
| language | 任意 | 文字列 | ボイス名とバッジの値の言語。例: ar、fr、zh-hans(URL の ?language= でも指定可)。その言語のテキストがないボイスは英語で表示され、コードがない場合や未対応の場合も英語になります。使用された言語はレスポンスヘッダー Content-Language で確認できます。 |
| engine | 任意 | 文字列 | API キーは自分の種類のボイスだけを一覧表示します(標準またはアドバンス。キー作成時に選択)。engine を送る場合は、キーの種類と一致させてください。 |
回答
| フィールド | タイプ | 説明 |
|---|---|---|
| voice_id | 整数 | 固有の音声識別子 |
| voice_name | 文字列 | 音声表示名 |
| voice_sample_url | 文字列 | 音声サンプルファイルのURL |
| voice_fees | 浮かぶ | この音声の利用料(0は無料) |
| voice_badges | 物体 | 音声に関する追加のメタデータ(例:言語、性別、年齢、ユースケース) |
| voice_engine | 文字列 | 標準または高度。標準エンジンの音声は「モード」を使用し、高度なエンジンの音声は「コンテキスト」「設定」「スタイル」「ペース」を使用します。参照: エンジンとモード. |
例
curl "https://moknah.io/api/v1/voices/" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.post(
"https://moknah.io/api/v1/voices/",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
voices = response.json()
for voice in voices:
print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
'https://moknah.io/api/v1/voices/',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const voices = await response.json();
console.log(voices);
回答例
[
{
"voice_id": 1328,
"voice_name": "Adnan",
"voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
"voice_fees": 0.0,
"voice_badges": {
"language": "Arabic",
"gender": "Male",
"age": "Young Adult",
"use_case": "Documentary, Audiobook, Article",
},
"voice_engine": "standard"
}
]
APIサポート
APIに関するご質問や問題については、こちらまでお問い合わせください。 api@moknah.io.