Demande de vidéo groupée à l'aide d'un modèle

Ce guide d'API fournit un aperçu de la génération de requêtes en masse à l'aide de modèles.

---

Les modèles simplifient le processus de génération de requêtes en masse. Pour réduire la saisie répétitive de données lors de la création de vidéos, vous pouvez créer un modèle à l'aide de l'API create template. Une fois établi, vous pouvez utiliser ce modèle plusieurs fois pour générer efficacement des requêtes en masse. Pour en savoir plus sur une requête en masse, lisez l'introduction à l'API create bulk request 🦊

Démarrage rapide

Plongeons-nous dans le vif du sujet et explorons comment créer une requête en masse à l'aide d'un modèle en masse.

Création d'une requête en masse à partir d'un modèle

Vous pouvez utiliser l''id' comme 'template_id' obtenu à partir de l'API de liste de modèles ou de l'API create template. Fournissez cet 'template_id' avec le "video_name" pour créer une requête en masse. Dans la réponse, vous recevrez des détails sur le nombre de vidéos réussies et celles qui ont échoué. Utilisez l'identifiant de la réponse pour vérifier l'état de la requête groupée à l'aide de l'API Bulk Status (video_status.md). Les configurations sont facultatives. Si vous envoyez une configuration, elle sera mise à jour dans le modèle et les vidéos seront générées conformément au nouveau modèle. Notez que si vous fournissez les configurations, vous devez également spécifier le champ scene_number.

• ID : identifiant de la requête groupée.
• Nombre de requêtes réussies : nombre de vidéos envoyées pour traitement.
• Nombre de requêtes échouées : nombre de vidéos dont le traitement a échoué.

RequêteRéponse

curl --request POST  \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/generate_video_from_template/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'  \
     --data { \
                "template_id": 45, \
                "csv_id": 123, \
                "configurations": [ \
                    { \
                        "scene_number": 1, \
                        "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_transition": "none", \
                        "audio_id": 2, \
                        "audio_service": "google_audio", \
                        "user_voice_speed": 1, \
                        "x_position": 0.604931, \
                        "y_position": 0.43101 \
                    } \
                ] \
            }

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