Ir para o conteúdo

Pedido de vídeo em massa

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

Solicitação de vídeo em massa

Uma solicitação em massa permite que você gere vários arquivos de vídeo personalizados de uma só vez usando um arquivo CSV com dados específicos do usuário. Em vez de criar cada áudio individualmente, você pode inserir vários campos, como nomes e detalhes da empresa, no CSV, e o sistema gerará automaticamente áudios personalizados para cada entrada. 🦊 Digamos que você queira criar arquivos de áudio personalizados para vários usuários. Seu arquivo CSV contém os seguintes dados:

Nome Nome da empresa
John Acme Corp
Jane Beta Ltd

Agora, em seu texto de áudio, você usa as macros suportadas como esta:

"Olá {{Nome}}, bem-vindo à {{Nome da empresa}}!"

Quando a solicitação em massa for processada, as macros serão substituídas pelos valores do CSV. Os áudios gerados seriam:

  1. "Olá John Smith, bem-vindo à Acme Corp!"
  2. "Olá Jane Doe, bem-vinda à Beta Ltd!"

Isso permite que você crie arquivos de áudio personalizados para cada usuário em seu CSV, tornando as solicitações em massa eficientes e personalizadas.

Início rápido

Vamos nos aprofundar e explorar como criar uma solicitação em massa com suas configurações personalizadas.

Criando uma solicitação em massa

Para criar uma solicitação em massa, use a seguinte solicitação de API. Ela permite que você defina várias configurações, incluindo texto de áudio, avatar e plano de fundo, para gerar uma solicitação em massa. Personalize os parâmetros para atender às suas necessidades. Se você tiver um modelo em massa, para usá-lo para criar uma solicitação em massa, use create bulk template API. Você pode obter o 'audio_id' e o 'audio_service' da audio listing API e o "csv_id" da csv listing API. Você pode usar macros no formato '{{}}' dentro do 'audio_text', que serão substituídos dinamicamente por valores do arquivo CSV fornecido. Por exemplo, se você incluir '{{First Name}}' no seu texto, ele será substituído por nomes como "John" e "Smith" para cada entrada correspondente no CSV, criando áudio personalizado para cada vídeo na lista. Oferecemos suporte a até 20 variáveis de modelo por solicitação. Certifique-se de que o número e os nomes dessas variáveis correspondam exatamente entre seu texto e o arquivo CSV. O texto da variável de modelo não diferencia maiúsculas de minúsculas. Se alguma variável de modelo estiver faltando no CSV, um erro será retornado. Na resposta, você receberá detalhes sobre o número de vídeos bem-sucedidos e aqueles que falharam. Use o 'id' da resposta para verificar o status da solicitação em massa usando bulk status API

  • 'id': O identificador para a 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/' \
     --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": []
}