Saltar a contenido

Solicitud de video en bloque usando plantilla

Esta guía de API proporciona una descripción general de la generación de solicitudes masivas mediante plantillas.

Las plantillas simplifican el proceso de generación de solicitudes masivas. Para reducir la necesidad de ingresar datos repetidamente al crear videos, puede crear una plantilla usando la API de creación de plantillas. Una vez establecida, puede usar esta plantilla varias veces para generar solicitudes masivas de manera eficiente. Para saber qué es una solicitud masiva, lea la Introducción a la API de creación de solicitudes masivas 🦊

Inicio rápido

Profundicemos y exploremos cómo crear una solicitud masiva usando una plantilla masiva.

Creación de una solicitud masiva a partir de una plantilla

Puede usar el 'id' como 'template_id' obtenido de la API de listado de plantillas o la API de creación de plantillas. Proporcione este 'template_id' junto con "video_name" para crear una solicitud masiva. En la respuesta, recibirá detalles sobre la cantidad de videos exitosos y los que han fallado. Utilice el 'id' de la respuesta para comprobar el estado de la solicitud masiva mediante la API de estado masivo. Las configuraciones son opcionales. Si envía alguna configuración, se actualizará en la plantilla y los vídeos se generarán según la nueva plantilla. Tenga en cuenta que si proporciona las configuraciones, también debe especificar el campo scene_number.

  • 'id': El identificador de la solicitud masiva.
  • 'successful_requests_count': El número de vídeos enviados correctamente para su procesamiento.
  • 'failed_requests_count': El número de vídeos que no se procesaron.
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": []
}