Ir para o conteúdo

Listagem de Voz

Este guia de API fornece uma visão geral de como listar vozes disponíveis em nossa plataforma.


Ao usar esta API, você poderá recuperar uma lista completa de todas as vozes disponíveis, incluindo opções padrão e personalizadas. Para gerar solicitações de vídeo em massa, você precisará do 'id' e do 'voice_service_name' correspondente para processar e gerenciar com eficiência várias solicitações em nossa plataforma. 🎧🎬

Início rápido

Vamos explorar como obter os detalhes da voz, para que você possa acessá-la e usá-la facilmente em seus vídeos. 🎧✨

Listando vozes padrão

Esta API fornece uma lista de vozes padrão. Selecione uma voz da lista e registre seu 'id' e 'voice_service_name', que são necessários para uso em criação de modelos ou criação de solicitações em massa.

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

Listando vozes personalizadas

Esta API fornece uma lista de vozes personalizadas. Selecione uma voz da lista e registre seu 'id' e 'voice_service_name', que são necessários para uso em criação de modelos ou criação de solicitações em massa.

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 status de voz personalizada

Para verificar o status de uma voz personalizada gerada, você precisa fornecer o 'id' em sua solicitação. O status do processo de geração de voz será incluído na resposta no campo 'status'. Use essas informações para monitorar o progresso e determinar o estado de conclusão de sua voz personalizada.

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