音声をオンラインでトリム — 任意の区間を切り出し、ホスト済みMP3を取得。
Fotovidは再エンコードなしで音声をトリムできます。コーデックとビットレートはそのまま維持されるため、切り出したクリップは元の音声と一致します。呼び出しは1回、インストールは不要です。
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
}
}'自前でffmpegを動かさない理由
音声のトリムはffmpegコマンド1行で済みます——それを serverless にデプロイしようとするまでは。ffmpegバイナリはほとんどの関数バンドルサイズ上限を軽く超え、コールドスタートは肥大化し、それでもなお元ファイルのダウンロード、サブプロセスの起動、出力のキャプチャ、結果をどこか永続的な場所へアップロードする処理を自分で組む必要があります。クリップを切り出すだけの作業にしては、あまりに多くの付随作業です。
- ffmpegの静的バイナリはLambda/Vercel/Netlifyのバンドルサイズやメモリの上限を軽く超え、レイヤーの維持も壊れやすい
- 入力ファイルの取得、サブプロセスの起動、標準出力のストリーミングを、関数のディスク容量やタイムアウトを超えないよう自前で制御する必要がある
- トリム後のファイルにも保存先が必要——ストレージ、ホスティング、クリーンアップはすべて自分の責任になる
- 着信音、短いサンプル、トリムしたボイスメモ、プレビュークリップが欲しいときは、これらすべてを運用せずにこのエンドポイントを使えばよい
リクエストパラメータ
POST /v1/audio/trim
| Field | Type | Default | Description |
|---|---|---|---|
| source_url* | string (URL) | — | 元音声のHTTPS URL(MP3、M4A、WAVなど) |
| params.start* | string | number | — | 「HH:MM:SS(.mmm)」形式、または秒数(例: 18.73) |
| params.end* | string | number | — | startより大きい値である必要があります。ファイル終端で切り詰められます |
最初の呼び出しを3ステップで
- 1無料のAPIキーを取得
サインアップし、ダッシュボードからキーを作成します。すべてのリクエストは Authorization: Bearer p6_<key_id>:<secret> ヘッダーで認証します。新規キーには無料の利用 credits が付与され、音声トリムを含むほとんどの操作は1 credit($1 = 100 credits)で利用できます。
- 2/v1/audio/trim へPOSTする
source_url に入力音声のhttps URLを、params オブジェクトに start と end を指定したJSONを送信します。両方ともHH:MM:SS.mmm形式のタイムスタンプ文字列、または秒数のいずれかを受け付けます——例えば start: "00:00:12.500"、end: "00:00:27" のように指定します。Fotovidが元ファイルをダウンロードし、その区間を切り出してMP3としてエンコードします。
- 3返されたMP3のURLを使う
レスポンスはフラットなJSONです: { id, type, url, expires_at, duration }。url はFotovidがホストするトリム済みクリップのMP3です。そのまま再生するか、ダウンロードして自分のバケットに保管し、保持期間を自分で管理してください。
