Cắt audio trực tuyến — cắt theo bất kỳ khoảng nào, trả về MP3 host sẵn.
Fotovid có thể cắt audio mà không cần re-encode — codec và bitrate được giữ nguyên, nên đoạn cắt khớp với file gốc. Một lệnh gọi, không cần cài đặt gì.
curl -X POST https://api.fotovid.co/v1/audio/trim \
-H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{
"source_url": "https://cdn.yoursite.com/voice-note.mp3",
"params": {
"start": 18.7,
"end": 42
}
}'Tại sao không tự chạy ffmpeg?
Cắt audio chỉ là một dòng lệnh ffmpeg — cho đến khi bạn thử triển khai nó trên serverless. Binary ffmpeg lớn hơn nhiều so với giới hạn dung lượng bundle của hầu hết các function, cold start phình to, và bạn vẫn phải tải file nguồn về, spawn một subprocess, thu lại output, rồi đẩy kết quả đi đâu đó lưu trữ bền vững. Đó là quá nhiều việc hạ tầng lặt vặt cho một việc đơn giản như cắt một đoạn clip.
- Binary tĩnh của ffmpeg vượt xa giới hạn dung lượng bundle và bộ nhớ của Lambda/Vercel/Netlify, còn layer thì khó bảo trì và dễ hỏng
- Bạn phải tải file đầu vào về, gọi ra một subprocess, rồi stream stdout mà không làm tràn disk hay vượt timeout của function
- File đã cắt vẫn cần một nơi lưu trữ — bạn phải tự lo storage, hosting và dọn dẹp
- Dùng endpoint này khi bạn cần một nhạc chuông, một đoạn sample ngắn, một voice note đã cắt, hay một clip preview mà không phải tự vận hành bất kỳ thứ nào ở trên
Tham số request
POST /v1/audio/trim
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | URL HTTPS của file audio nguồn (MP3, M4A, WAV, ...) |
| params.start* | string | number | — | "HH:MM:SS(.mmm)" hoặc số giây (ví dụ: 18.73) |
| params.end* | string | number | — | Phải lớn hơn start; bị cắt ngắn tại EOF |
Lệnh gọi đầu tiên của bạn trong ba bước
- 1Lấy API key miễn phí
Đăng ký và tạo key từ dashboard. Mọi request đều xác thực bằng header Authorization: Bearer p6_<key_id>:<secret>. Key mới sẽ có sẵn credit miễn phí — hầu hết các thao tác, kể cả cắt audio, tốn 1 credit ($1 = 100 credits).
- 2POST tới /v1/audio/trim
Gửi một JSON envelope với source_url trỏ tới URL https của audio đầu vào, cùng một object params chứa start và end. Cả hai đều nhận chuỗi timestamp HH:MM:SS.mmm hoặc số giây — ví dụ start: "00:00:12.500", end: "00:00:27". Fotovid sẽ tải file nguồn, cắt đúng khoảng đó, rồi encode kết quả thành MP3.
- 3Sử dụng URL MP3 trả về
Response là JSON phẳng: { id, type, url, expires_at, duration }. url là file MP3 được Fotovid host cho đoạn clip đã cắt của bạn. Bạn có thể phát trực tiếp, hoặc tải về và lưu bản sao riêng trong bucket của mình để tự kiểm soát thời gian lưu trữ.
Câu hỏi thường gặp
Triển khai chỉ với một lệnh gọi API
Lấy một key miễn phí và thực hiện lệnh gọi đầu tiên trong chưa đầy năm phút.