Saltar a contenido

Solicitud de video en bloque

Esta guía de API proporciona una descripción general de la generación de solicitudes en masa.

Solicitud de video en masa

Una solicitud en masa le permite generar múltiples archivos de video personalizados a la vez mediante un archivo CSV con datos específicos del usuario. En lugar de crear cada audio individualmente, puede ingresar varios campos, como nombres y detalles de la empresa, en el CSV, y el sistema generará automáticamente audios personalizados para cada entrada. 🦊

Digamos que desea crear archivos de audio personalizados para múltiples usuarios. Su archivo CSV contiene los siguientes datos:

Nombre Nombre de la empresa
John Acme Corp
Jane Beta Ltd

Ahora, en su texto de audio, use las macros compatibles de esta manera:

"¡Hola {{Nombre}}, bienvenido a {{Nombre de la empresa}}!"

Cuando se procese la solicitud en masa, las macros se reemplazarán con los valores del CSV. Los audios generados serían:

  1. "Hola John Smith, ¡bienvenido a Acme Corp!"
  2. "Hola Jane Doe, ¡bienvenido a Beta Ltd!"

Esto le permite crear archivos de audio personalizados para cada usuario en su CSV, lo que hace que las solicitudes masivas sean eficientes y personalizadas.

Inicio rápido

Profundicemos y exploremos cómo crear una solicitud masiva con sus configuraciones personalizadas.

Creación de una solicitud masiva

Para crear una solicitud masiva, use la siguiente solicitud de API. Le permite definir varias configuraciones, incluyendo texto de audio, avatar y fondo, para generar una solicitud masiva. Personalice los parámetros para que se ajusten a sus necesidades. Si tiene una plantilla masiva, para usarla para crear una solicitud masiva, use create bulk template API. Puede obtener el 'audio_id' y el 'audio_service' de la audio listing API y el "csv_id" de la csv listing API. Puedes usar macros con el formato '{{}}' dentro del 'audio_text', que se reemplazará dinámicamente con los valores del archivo CSV que proporcionaste. Por ejemplo, si incluyes '{{First Name}}' en tu texto, se reemplazará con nombres como "John" y "Smith" para cada entrada correspondiente en el CSV, creando un audio personalizado para cada video de la lista. Admitimos hasta 20 variables de plantilla por solicitud. Asegúrate de que el número y los nombres de estas variables coincidan exactamente en tu texto y en el archivo CSV. El texto de las variables de plantilla no distingue entre mayúsculas y minúsculas. Si falta alguna variable de plantilla en el CSV, se devolverá un error. En la respuesta, recibirás detalles sobre el número de videos exitosos y los que fallaron. Usa el 'id' de la respuesta para verificar el estado de la solicitud masiva mediante bulk status API

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