비디오에서 오디오를 추출해 MP3와 재생 시간을 함께 받아보세요.
비디오 URL을 POST하면 MP3와 재생 시간을 돌려받아요. 추출 작업은 Fotovid의 호스팅 인프라에서 실행되므로, 여러분의 스택에는 바이너리도 파이프라인도 필요 없어요.
curl -X POST https://api.fotovid.co/v1/video/extract-audio \
-H "Authorization: Bearer p6_YOUR_KEY_ID:YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{
"source_url": "https://cdn.yoursite.com/talk.mp4"
}'비디오에서 오디오를 뽑아내는 데 서버에 ffmpeg까지는 필요 없어요
비디오에서 오디오 트랙을 뽑아내는 건 ffmpeg 명령어 한 줄이면 끝나는 일이에요. 서버리스 함수 안에서 실행하려고 하기 전까지는요. 정적 빌드된 ffmpeg 바이너리는 수십 MB에 달해서 Vercel, Netlify, Lambda의 배포 용량 제한을 훌쩍 넘겨버려요. 비디오를 디코딩해서 MP3로 다시 인코딩하는 작업은 CPU와 메모리를 많이 잡아먹기 때문에, 가장 큰 인스턴스가 아니라면 함수 타임아웃과 콜드 스타트 한도에 걸리고 말아요. 게다가 여전히 소스 파일을 다운로드하고, 서브프로세스를 실행하고, 출력 파일을 받아서, 결과물을 지속적으로 보관할 스토리지에 업로드까지 해야 해요.
- ffmpeg 정적 빌드는 대부분의 서버리스 배포 아티팩트에 번들로 넣기에는 용량이 너무 커요
- 오디오 추출은 트랙 전체를 다시 인코딩하기 때문에 CPU, 메모리, 타임아웃 상한에 부딪혀요
- 결과로 나온 MP3를 호스팅하고 앱에서 쓸 수 있는 URL을 돌려줄 곳이 필요해요
- 미디어 처리 파이프라인을 직접 관리하지 않고 MP3만 얻고 싶을 때 이 엔드포인트를 쓰세요
요청 파라미터
POST /v1/video/extract-audio
파라미터는 없어요. source_url만 POST하면 MP3와 재생 시간을 돌려받아요.
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | 소스 비디오의 HTTPS URL (MP4, MOV, WebM, MKV 등) |
세 단계로 끝내는 첫 호출
- 1무료 API 키 발급받기
가입 후 대시보드에서 키를 생성하세요. 요청은 Authorization: Bearer p6_<key_id>:<secret> 헤더로 인증해요. 새로 발급한 키에는 무료 credits가 기본으로 들어 있고, 요금은 순수 사용량 기반이에요 — $1로 100 credits를 구매할 수 있고 이 작업은 호출당 약 1 credit이 들기 때문에, 미리 약정할 필요가 없어요.
- 2/v1/video/extract-audio로 비디오 POST하기
https://api.fotovid.co/v1/video/extract-audio로 표준 엔벨로프 형식의 요청을 보내세요: 비디오의 HTTPS URL을 가리키는 source_url과 빈 params 객체를 담으면 돼요 — 오디오 추출은 파라미터를 받지 않아요. Fotovid는 비디오를 다운로드해 오디오 트랙을 분리한 뒤 동기적으로 MP3로 인코딩하고, 파일이 준비되는 즉시 응답을 돌려줘요.
- 3반환된 MP3 URL 사용하기
응답은 플랫한 JSON이에요: id, type, fotovid가 호스팅하는 MP3 url, expires_at, 그리고 초 단위 오디오 재생 시간이 포함돼요. 이 url을 팟캐스트 피드, 전사나 AI 파이프라인, 또는 플레이어에 바로 연결하세요. 호스팅된 결과물은 일시적이므로, 여러분의 플로우 안에서 MP3 사본을 직접 다운로드해 저장해 두세요.
