{
"status": "IN_QUEUE",
"request_id": "01a04482-39ff-7632-b67a-97d87c97ffdb",
"response_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb",
"status_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb/status",
"cancel_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb/cancel",
"logs": null,
"metrics": [],
"queue_position": 0
}
curl --location --request POST 'https://zylalabs.com/api/13644/waveform+api/30943/get+id' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"media_url": "https://storage.googleapis.com/falserverless/example_inputs/ffmpeg-audio.wav",
"points_per_second": 4,
"precision": 2,
"smoothing_window": 3
}'
{
"waveform": [
-0.14,
-0.46,
-0.67,
-0.25,
-0.42,
-0.17,
-0.52,
-1,
-0.4,
-0.13,
-0.36,
-0.52,
-0.36,
-0.13,
-0.2,
-0.52,
-0.45,
-0.31,
-0.13,
-0.06,
0.07
],
"duration": 5.36,
"points": 21,
"precision": 2
}
curl --location --request GET 'https://zylalabs.com/api/13644/waveform+api/30944/create+waveform&request_id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Forma de onda API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A API Waveform gera uma representação numérica de uma forma de onda de áudio a partir de uma URL de mídia fornecida. Basta enviar uma URL acessível publicamente contendo um arquivo de áudio ou vídeo e a API analisa a trilha de áudio e retorna uma forma de onda estruturada que pode ser usada para visualizações, interfaces de reprodução, análise de áudio e aplicações multimídia
A resposta inclui um array de forma de onda contendo valores de amplitude normalizados que representam o sinal de áudio ao longo da duração analisada. Esses valores podem ser usados para gerar visualizações de formas de onda, como linhas do tempo, players de áudio, barras de progresso, interfaces de edição e componentes multimídia interativos. Valores positivos e negativos representam a amplitude do sinal de áudio, enquanto o número de pontos retornados determina o nível de detalhe disponível para visualização
A API também retorna a duração total do conteúdo multimídia analisado em segundos, permitindo que as aplicações sincronizem a forma de onda com a reprodução. O campo "pontos" indica o número de amostras de forma de onda retornadas, enquanto "precisão" especifica a precisão decimal usada para os valores da forma de onda
O endpoint POST Get ID retorna um ID de solicitação e informações de status sobre o processo de geração da forma de onda O endpoint GET Create Waveform retorna um array de forma de onda estruturado duração do áudio número de pontos e precisão dos valores da forma de onda
Os campos-chave na resposta POST Get ID incluem `request_id`, `status` e `queue_position`. Na resposta GET Create Waveform, os campos importantes são `waveform`, `duration`, `points` e `precision`, que fornecem detalhes essenciais para a visualização de áudio
Os dados da resposta estão organizados em formato JSON A resposta do POST Get ID inclui informações de status e solicitação enquanto a resposta do GET Create Waveform contém um array de valores de forma de onda juntamente com metadados como duração e precisão facilitando a análise e utilização
O endpoint POST Get ID não requer parâmetros O endpoint GET Create Waveform aceita uma URL de mídia que deve ser publicamente acessível Os usuários podem personalizar suas solicitações especificando a URL do arquivo de áudio ou vídeo que desejam analisar
Os casos de uso típicos incluem a geração de representações visuais de áudio para reprodutores de música a criação de componentes multimídia interativos e a condução de análises de áudio para fins de pesquisa ou desenvolvimento Os dados de forma de onda podem aprimorar interfaces de usuário e melhorar aplicações relacionadas a áudio
Os usuários podem visualizar os dados de forma de onda mapeando os valores de amplitude para representações gráficas, como formas de onda ou barras de progresso Os campos de duração e precisão ajudam a sincronizar as visualizações com a reprodução de áudio, melhorando a experiência do usuário em aplicações multimídia
A precisão dos dados é mantida por meio de algoritmos de processamento robustos que analisam faixas de áudio a partir das URLs de mídia fornecidas A API garante que os pontos da forma de onda reflitam com precisão a amplitude do sinal de áudio permitindo visualizações e análises confiáveis
Os usuários podem esperar valores de amplitude normalizados na matriz de forma de onda, geralmente variando de -1 a 1. O número de pontos retornados variará com base na duração e complexidade do áudio, fornecendo uma representação detalhada adequada para várias necessidades de visualização