Aller au contenu

Demande de vidéo groupée

Ce guide API fournit un aperçu de la génération de requêtes en masse.

Requête vidéo en masse

Une requête en masse vous permet de générer plusieurs fichiers vidéo personnalisés en une seule fois en utilisant un fichier CSV avec des données spécifiques à l'utilisateur. Au lieu de créer chaque audio individuellement, vous pouvez saisir divers champs, tels que les noms et les détails de l'entreprise, dans le CSV, et le système générera automatiquement des audios personnalisés pour chaque entrée. 🦊

Supposons que vous souhaitiez créer des fichiers audio personnalisés pour plusieurs utilisateurs. Votre fichier CSV contient les données suivantes :

Prénom Nom de l'entreprise
John Acme Corp
Jane Beta Ltd

Maintenant, dans votre texte audio, vous utilisez les macros prises en charge comme ceci : "Bonjour {{Prénom}}, bienvenue chez {{Nom de l'entreprise}} !" Lorsque la requête en masse est traitée, les macros seront remplacées par les valeurs du CSV. Français Les audios générés seraient :

  1. "Bonjour John Smith, bienvenue chez Acme Corp !"
  2. "Bonjour Jane Doe, bienvenue chez Beta Ltd !"

Cela vous permet de créer des fichiers audio personnalisés pour chaque utilisateur dans votre CSV, rendant les demandes groupées à la fois efficaces et personnalisées.

Démarrage rapide

Plongeons-nous dans le vif du sujet et explorons comment créer une demande groupée avec vos configurations personnalisées.

Création d'une demande groupée

Pour créer une demande groupée, utilisez la requête API suivante. Elle vous permet de définir divers paramètres, notamment le texte audio, l'avatar et l'arrière-plan, pour générer une demande groupée. Personnalisez les paramètres en fonction de vos besoins. Si vous disposez d'un modèle groupé, pour l'utiliser pour créer une demande groupée, utilisez create bulk template API. Vous pouvez obtenir les 'audio_id' et 'audio_service' à partir de l'API de liste audio et le "csv_id" à partir de l'API de liste csv. Vous pouvez utiliser des macros au format '{{}}' dans le texte 'audio_text', qui seront remplacées dynamiquement par les valeurs du fichier CSV fourni. Par exemple, si vous incluez '{{Prénom}}' dans votre texte, il sera remplacé par des noms tels que « John » et « Smith » pour chaque entrée correspondante du fichier CSV, créant ainsi un son personnalisé pour chaque vidéo de la liste. Nous prenons en charge jusqu'à 20 variables de modèle par requête. Assurez-vous que le nombre et les noms de ces variables correspondent exactement à ceux du fichier CSV. La casse du texte des variables de modèle n'est pas sensible à la casse. Si des variables de modèle sont manquantes dans le fichier CSV, une erreur sera renvoyée. La réponse vous indiquera le nombre de vidéos réussies et celles ayant échoué. Utilisez l'identifiant 'id' de la réponse pour vérifier l'état de la requête groupée à l'aide de Bulk Status API

  • 'id' : identifiant de la requête groupée.
  • 'successful_requests_count': Nombre de vidéos envoyées avec succès pour traitement.
  • 'failed_requests_count': Nombre de vidéos dont le traitement a échoué.
curl --request POST \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/generate_video/' \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json' \
     --data { \
                "csv_id": 45 \
                "subtitles_flag": false \
                "video_name": "My First Video" \
                "configurations": [ \
                    { \
                        "audio_text": "Hi, My name is {{First Name}}", \
                        "avatar": 102, \
                        "avatar_size": 76, \
                        "background_color": "#ffffff", \
                        "background_music_is_personalized": "system", \
                        "background_music_volume": 0.1, \
                        "frame_height": 1080, \
                        "frame_width": 1920, \
                        "is_personalized_audio": false, \
                        "scene_number": 1, \
                        "scene_transition": "none", \
                        "audio_id": 2, \
                        "audio_service": "google_audio", \
                        "user_voice_speed": 1, \
                        "x_position": 0.604931, \
                        "y_position": 0.43101 \
                    } \
                ] \
            }

{
    "id": 178,
    "message": "Requests Created",
    "successful_requests_count": 3,
    "failed_requests_count": 0,
    "failed_requests": []
}