Saltar a contenido

Lista de voces

Esta guía de API ofrece una descripción general de cómo listar las voces disponibles en nuestra plataforma.

Al usar esta API, podrá obtener una lista completa de todas las voces disponibles, incluyendo las opciones predeterminadas y personalizadas. Para generar solicitudes de video masivas, necesitará el 'id' y el 'voice_service_name' correspondiente para procesar y gestionar eficientemente múltiples solicitudes en nuestra plataforma. 🎧🎬

Inicio rápido

Exploremos cómo obtener los detalles de la voz para que pueda acceder a ellos y usarlos fácilmente en sus videos. 🎧✨

Listado de voces predeterminadas

Esta API proporciona una lista de voces predeterminadas. Seleccione una voz de la lista y grabe su 'id' y 'voice_service_name', que son necesarios para su uso en la creación de plantillas o la creación de solicitudes masivas.

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"
    }
]

Listado de voces personalizadas.

Esta API proporciona una lista de voces personalizadas. Seleccione una voz de la lista y registre su 'id' y 'voice_service_name', necesarios para la creación de plantillas (template.md) o solicitudes masivas (video_request.md).

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"
    }
]

Verificar el estado de voz personalizado

Para comprobar el estado de una voz personalizada generada, debe proporcionar el 'id' en su solicitud. El estado del proceso de generación de la voz se incluirá en la respuesta, en el campo 'status'. Utilice esta información para supervisar el progreso y determinar si su voz personalizada está completa.

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": "Afrikaans",
    "supported_languages": [
        {
            "name": "Greek",
            "language_code": "el-GR"
        },
        {
            "name": "Russian",
            "language_code": "ru-RU"
        }
    ],
    "label": "👤 My voice",
    "default_language": "en-US",
    "gender": "Female",
    "audio_id": "QqH3AY53vGZpD1HCthXE",
    "user": 31,
    "status": "Completed",
    "voice_service_name": "resemble_audio"
}