Ir para o conteúdo

Pedido de vídeo em massa usando modelo

Este guia de API fornece uma visão geral da geração de solicitações em massa usando modelos.

Os modelos simplificam o processo de geração de solicitações em massa. Para reduzir a necessidade de entrada repetitiva de dados ao criar vídeos, você pode criar um modelo usando a API de criação de modelo. Uma vez estabelecido, você pode usar este modelo várias vezes para gerar solicitações em massa de forma eficiente. Para saber o que é uma solicitação em massa, leia introdução à API de criação de solicitação em massa 🦊

Início rápido

Vamos mergulhar e explorar como criar uma solicitação em massa usando um modelo em massa.

Criando solicitação em massa a partir do modelo

Você pode usar o 'id' como 'template_id' obtido da API de listagem de modelos ou API de criação de modelo. Forneça este 'template_id' junto com o "video_name" para criar uma solicitação em massa. Na resposta, você receberá detalhes sobre o número de vídeos bem-sucedidos e quaisquer que tenham falhado. Use o 'id' da resposta para verificar o status da solicitação em massa usando bulk status API As configurações são opcionais. Se você enviar qualquer configuração, ela será atualizada no modelo e os vídeos serão gerados de acordo com o novo modelo. Observe que, se você fornecer as configurations, também deverá especificar o campo scene_number.

  • 'id': O identificador da solicitação em massa.
  • 'successful_requests_count': O número de vídeos enviados com sucesso para processamento.
  • 'failed_requests_count': O número de vídeos que falharam no processamento.
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": []
}