Moknah ドキュメント
無料で始める
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.