Avançar 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Este pedido: ≈0,001 $ 1 crédito da API · ≈ 0,11 ₽ Executar nesta página

Obter chave de API
Utility Outro #ffmpeg

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

Utility · Dados (JSON)

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

URL que aponta para o ficheiro de áudio a analisar.

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

Taxa de amostragem da forma de onda em pontos por segundo de áudio, variando em detalhe de grosseira para valores como 1–2 a mais fina para valores como 4–10.

predefinição 2

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

predefinição 3

Tamanho da janela de suavização, que tem de 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre FFmpeg API Waveform

Analisa o áudio em `media_url` e devolve a duração, o número de pontos, a precisão e um array `waveform` de valores entre -1 e 1. `points_per_second` varia entre 1 e 10, `precision` define as casas decimais entre 1 e 6 e `smoothing_window`, entre 1 e 21, suaviza a curva e tem de ser ímpar.

Parâmetros

NomeTipo PredefiniçãoPermitido Descrição
media_urlobrigatório
Tipostring
URL que aponta para o ficheiro de áudio a analisar.
points_per_secondopcional
Tiponumber
Predefinição4
1 – 10
Taxa de amostragem da forma de onda em pontos por segundo de áudio, variando em detalhe de grosseira para valores como 1–2 a mais fina para valores como 4–10.
precisionopcional
Tipointeger
Predefinição2
1 – 6
Número 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
Predefinição3
1 – 21
Tamanho da janela de suavização, que tem de ser ímpar. Janelas maiores produzem formas de onda mais suaves.
obrigatório

Resultado

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
waveform
array of numberMatriz de forma de onda normalizada que contém duração do áudio × points_per_second 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 utilizada para os valores da forma de onda.

Mais modelos: Outro

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