Aller au contenu

Liste des voix

Ce guide API vous explique comment répertorier les voix disponibles sur notre plateforme.

Grâce à cette API, vous pourrez récupérer la liste complète de toutes les voix disponibles, y compris les options par défaut et personnalisées. Pour générer des requêtes vidéo groupées, vous aurez besoin de l'identifiant et du nom du service vocal correspondant afin de traiter et de gérer efficacement plusieurs requêtes sur notre plateforme. 🎧🎬

Démarrage rapide

Voyons comment obtenir les détails des voix pour y accéder facilement et les utiliser dans vos vidéos. 🎧✨

Liste des voix par défaut

Cette API fournit une liste de voix par défaut. Sélectionnez une voix dans la liste et enregistrez son identifiant et son nom, nécessaires à la création de modèles (template.md) ou de requêtes groupées (video_request.md).

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

Liste des voix personnalisées.

Cette API fournit une liste de voix personnalisées. Sélectionnez une voix dans la liste et enregistrez son identifiant et son nom de service vocal, nécessaires à la création de modèles (template.md) ou de requêtes groupées (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"
    }
]

Vérifier l'état de la voix personnalisée.

Pour vérifier l'état d'une voix personnalisée générée, vous devez fournir l'identifiant dans votre requête. L'état du processus de génération de la voix sera indiqué dans la réponse, dans le champ « statut ». Utilisez ces informations pour suivre la progression et déterminer l'état d'achèvement de votre voix personnalisée.

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