コンテンツにスキップ

音声一覧

この API ガイドでは、プラットフォームで利用可能な音声を一覧表示する方法の概要を説明します。

この API を使用すると、デフォルトとパーソナライズされたオプションの両方を含む、利用可能なすべての音声の完全なリストを取得できます。一括ビデオ リクエストを生成するには、プラットフォーム全体で複数のリクエストを効率的に処理および管理するために、'id' と対応する 'voice_service_name' が必要です。 🎧🎬

クイック スタート

音声の詳細を取得する方法を調べて、簡単にアクセスしてビデオで使用できるようにします。 🎧✨

デフォルトの音声の一覧表示

この API は、デフォルトの音声のリストを提供します。リストから音声を選択し、その 'id' と 'voice_service_name' を記録します。これらは、テンプレートの作成 または 一括リクエストの作成 で使用するために必要です。

curl --request GET \
      --url 'https://api.immersive-fox.com/v1/voice/default_voices/' \
      --header 'X-Api-Key: <your-api-key>' \
      --header 'Content-Type: application/json'

[
    {
     "id": 2,
      "language": "Afrikaans",
      "label": "󰑠 Afrikaans - Informative",
      "gender": "Female",
      "language_code": "af-ZA",
      "voice_service_name": "google_audio"
    },
];

パーソナライズされた音声の一覧表示

この API は、パーソナライズされた音声の一覧を提供します。リストから音声を選択し、その'id'と'voice_service_name'を記録します。これらは、テンプレートの作成または一括リクエストの作成で使用するために必要です。

curl --request GET \
--url 'https://api.immersive-fox.com/v1/voice/personalized_voices/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json'

    [
        {
            "id": 2,
            "language": "Afrikaans",
            "supported_languages": [
                {
                    "name": "Greek",
                    "language_code": "el-GR"
                },
                {
                    "name": "Russian",
                    "language_code": "ru-RU"
                }
            ],
            "label": "👤 My voice",
            "default_language": "en-US",
            "gender": "Male",
            "audio_id": "QqH3AY53vGZpD1HCthXE",
            "user": 31,
            "voice_service_name": "resemble_audio"
        }
    ]
    ```


### パーソナライズされた音声のステータスを確認する

生成されたパーソナライズされた音声のステータスを確認するには、リクエストに **'id'** を指定する必要があります。音声生成プロセスのステータスは、**'status'** フィールドの応答に含まれます。この情報を使用して進行状況を監視し、パーソナライズされた音声の完了状態を判断します。

=== "リクエスト"

```bash
curl --request GET \
--url 'https://api.immersive-fox.com/v1/voice/status/<voice_id>' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json'

{
    "id": 2,
    "language": "アフリカーンス語",
    "supported_languages": [
        {
            "name": "ギリシャ語",
            "language_code": "el-GR"
        },
        {
        "name": "ロシア語",
        "language_code": "ru-RU"
        }
    ],
"label": "👤 My voice",
"default_language": "en-US",
"gender": "女性",
"audio_id": "QqH3AY53vGZpD1HCthXE",
"user": 31,
"status": "完了",
"voice_service_name": "resemble_audio"
}