Ir para a navegação

Vídeo para música

Gere música de fundo a partir de um ou mais arquivos de vídeo. Os vídeos são combinados em ordem. A descrição e as tags de estilo opcionais influenciam a música gerada.

Cabeçalhos

xi-api-keystringOpcional

Parâmetros de consulta

output_formatenumOpcional

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

enable_loggingbooleanOpcionalPadrão é true

Quando enable_logging estiver definido como false, o modo de retenção zero será usado para a solicitação. O modo de retenção zero só pode ser usado por clientes empresariais.

Solicitação

This endpoint expects a multipart form with multiple files.
videosfilesObrigatório

Um ou mais arquivos de vídeo enviados por meio de um array FormData (multipart/form-data). Eles serão combinados em um único codec, na ordem enviada. É permitido um máximo de 10 vídeos, e o tamanho total do vídeo combinado é limitado a 200 MB. No total, o vídeo pode ter até 600 segundos de duração. Observe que combinar vários vídeos pode aumentar significativamente a duração da solicitação. Se possível, combine os vídeos antecipadamente.

descriptionstring or nullOpcional1-4100 characters

Descrição textual opcional da música que você deseja. São permitidos no máximo 4.100 caracteres.

tagslist of stringsOpcionalPadrão é []

Lista opcional de tags de estilo (por exemplo, [‘upbeat’, ‘cinematic’]). É permitido um máximo de 10 tags.

model_idenumOpcionalPadrão é music_v1

O modelo a ser usado na geração.

Valores permitidos:
add_sfxbooleanOpcionalPadrão é false

Quando true, incorpora os sinais de efeitos sonoros do vídeo.

separate_tracksbooleanOpcionalPadrão é false

Quando true, retorna um ZIP com faixas de áudio separadas de música e efeitos sonoros, em vez de um único arquivo mixado. Use isso para ter mais flexibilidade ao sobrepor as faixas.

use_audio_as_referencebooleanOpcionalPadrão é false

Quando true, analisa a faixa de áudio do vídeo e usa seus gêneros, BPM, instrumentação, clima e arco como características de referência para a geração de música.

sign_with_c2pabooleanOpcionalPadrão é false

Se deve assinar a música gerada com C2PA. Aplicável apenas a arquivos mp3.

Cabeçalhos de resposta

song-idstringOpcional

Identificador exclusivo da música gerada

Resposta

Arquivo de áudio gerado que corresponde ao vídeo. O Content-Type e a extensão do arquivo dependem do parâmetro output_format (o padrão é mp3).

Erros

403
Forbidden Error
422
Unprocessable Entity Error