Bỏ qua đến nội dung

FFmpeg API Waveform

Tích hợp

Id mô hình 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"

Yêu cầu này: ≈0,001 $ 1 tín dụng API Chạy trên trang này

Lấy khóa API
Utility Khác #ffmpeg

Tạo dữ liệu dạng sóng đã chuẩn hóa từ tệp âm thanh để vẽ biểu đồ trực quan

Utility · Dữ liệu (JSON)

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

URL trỏ đến tệp âm thanh cần phân tích.

Nâng cao points_per_second · precision · smoothing_window
mặc định 4

Tốc độ lấy mẫu dạng sóng tính theo điểm trên mỗi giây âm thanh, với mức độ chi tiết từ thô ở các giá trị như 1–2 đến mịn hơn ở các giá trị như 4–10.

mặc định 2

Số chữ số thập phân của các giá trị dạng sóng; số lượng càng tăng thì tải trọng càng lớn nhưng độ chính xác số càng cao.

mặc định 3

Kích thước cửa sổ làm mượt, phải là số lẻ. Cửa sổ lớn hơn tạo ra dạng sóng mượt hơn.

POST /run/ffmpeg-api/waveform?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về FFmpeg API Waveform

Phân tích âm thanh tại `media_url` và trả về thời lượng, số điểm, độ chính xác cùng mảng `waveform` chứa các giá trị từ -1 đến 1. `points_per_second` từ 1 đến 10, `precision` đặt số chữ số thập phân từ 1 đến 6, còn `smoothing_window` từ 1 đến 21 làm mượt đường cong và phải là số lẻ.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
media_urlbắt buộc
Kiểustring
URL trỏ đến tệp âm thanh cần phân tích.
points_per_secondtùy chọn
Kiểunumber
Mặc định4
1 – 10
Tốc độ lấy mẫu dạng sóng tính theo điểm trên mỗi giây âm thanh, với mức độ chi tiết từ thô ở các giá trị như 1–2 đến mịn hơn ở các giá trị như 4–10.
precisiontùy chọn
Kiểuinteger
Mặc định2
1 – 6
Số chữ số thập phân của các giá trị dạng sóng; số lượng càng tăng thì tải trọng càng lớn nhưng độ chính xác số càng cao.
smoothing_windowtùy chọn
Kiểuinteger
Mặc định3
1 – 21
Kích thước cửa sổ làm mượt, phải là số lẻ. Cửa sổ lớn hơn tạo ra dạng sóng mượt hơn.
bắt buộc

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
waveform
array of numberMảng dạng sóng đã chuẩn hóa chứa duration × points_per_second điểm âm thanh, mỗi điểm nằm trong phạm vi -1 đến 1.
duration
numberThời lượng âm thanh, tính bằng giây.
points
integerTổng số điểm dữ liệu dạng sóng.
precision
integerĐộ chính xác thập phân dùng cho các giá trị dạng sóng.

Thêm mô hình: Khác

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/ffmpeg-api/waveform.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt