Ir para o conteúdo

FFmpeg API Waveform

Integrar

ID do modelo ffmpeg-api/waveform
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ffmpeg-api/waveform?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "media_url": "https://example.com/your-file.bin"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitação: ≈$ 0,001 1 crédito de API Executar nesta página

Obter chave de API
Utility Outro #ffmpeg

Gera dados de forma de onda normalizados a partir de um arquivo de áudio para desenhar visualizações

Utility · Dados (JSON)

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório

URL que aponta para o arquivo de áudio a ser analisado.

Avançado points_per_second · precision · smoothing_window
padrão 4

Taxa de amostragem da forma de onda em pontos por segundo de áudio, variando em detalhamento de grosseiro, em valores como 1–2, a mais preciso, em valores como 4–10.

padrão 2

Contagem de casas decimais dos valores da forma de onda, trocando um payload maior por maior precisão numérica à medida que a contagem aumenta.

padrão 3

Tamanho da janela de suavização, que deve ser ímpar. Janelas maiores produzem formas de onda mais suaves.

POST /run/ffmpeg-api/waveform?wait=20 cotação → $ 0,001
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ffmpeg-api/waveform?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "media_url": "https://example.com/your-file.bin"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre FFmpeg API Waveform

Analisa o áudio em `media_url` e retorna a duração, a contagem de pontos, a precisão e uma matriz `waveform` de valores entre -1 e 1. `points_per_second` varia de 1 a 10, `precision` define casas decimais de 1 a 6 e `smoothing_window` de 1 a 21 suaviza a curva e deve ser ímpar.

Parâmetros

NomeTipo PadrãoPermitido Descrição
media_urlobrigatório
Tipostring
URL que aponta para o arquivo de áudio a ser analisado.
points_per_secondopcional
Tiponumber
Padrão4
1 – 10
Taxa de amostragem da forma de onda em pontos por segundo de áudio, variando em detalhamento de grosseiro, em valores como 1–2, a mais preciso, em valores como 4–10.
precisionopcional
Tipointeger
Padrão2
1 – 6
Contagem de casas decimais dos valores da forma de onda, trocando um payload maior por maior precisão numérica à medida que a contagem aumenta.
smoothing_windowopcional
Tipointeger
Padrão3
1 – 21
Tamanho da janela de suavização, que deve ser ímpar. Janelas maiores produzem formas de onda mais suaves.
obrigatório

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ffmpeg-api/waveform",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1,
    "usd": "0.001",
    "charged": 1,
    "refunded": 0
  },
  "input": {
    "media_url": "https://example.com/your-file.bin"
  },
  "output": {
    "waveform": [
      1.0
    ],
    "duration": 5,
    "points": 1,
    "precision": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
waveform
array of numberMatriz de forma de onda normalizada contendo duração do áudio × pontos_por_segundo pontos, cada um no intervalo de -1 a 1.
duration
numberDuração do áudio, expressa em segundos.
points
integerContagem total de pontos de dados da forma de onda.
precision
integerPrecisão decimal usada para os valores da forma de onda.

Mais modelos: Outro

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/ffmpeg-api/waveform.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt