Deno Deployプロジェクトにffmpeg.wasmをバンドルするだけではダメですか?

インポート自体はできますが、isolateのCPU時間とメモリの上限は実際の動画をエンコードするのに必要な水準を大きく下回っており、大きなファイルをWasmモジュールにストリーム処理することもできません。デモの小さなクリップでは動作しますが、本番環境では破綻します。Fotovidは専用インフラ上でネイティブのffmpegバイナリを実行するため、通常の長さの動画がisolateの制限に引っかかることなくエンコードされます。

Fotovidを呼び出すと、動画エンコード中はisolateがブロックされますか?

小さめのソースであれば、これらのエンドポイントは同期的に応答を返します。fetchを1回awaitするだけで、完成した結果のURLが返ってきます。より大きい、あるいは長い動画のウォーターマーク処理(720p超または15秒超)は非同期タスクとして実行され、ポーリングまたはwebhookで受け取ります。いずれの場合もエンコードはFotovid側で行われ、あなたのisolate内では行われないため、保持しているのはHTTPリクエストだけで、isolateのCPUを消費することはありません。

入力動画はどこから取得されますか?

すべてのエンドポイントはsource_url(Fotovidが取得できるHTTPS URL)を受け取ります。オブジェクトストレージ内のファイル、署名付きURL、あるいは公開アクセス可能な任意のリンクを指定してください。バイト列をisolate経由でアップロードする必要は一切なく、Deno Deployのリクエストサイズや実行時間の制約を完全に回避できます。

結果のURLはどのくらいの期間有効ですか?

レスポンスには、Fotovidがホストする結果のexpires_atタイムスタンプが含まれます。このURLは永続的なストレージではなく、あくまで一時的な受け渡し用と考えてください。長期保存が必要な場合は取得して自分のバケットにコピーを保存しましょう。そうすることで、保持期間とCDNを自分でコントロールできます。

Deno Deployから他にどんな操作を呼び出せますか?

すべての操作を、操作ごとに1回のfetch()で呼び出せます:動画のトリム、音声の抽出、音声のトリム、カバーフレームの取得、画像へのウォーターマーク付与、ファイルのメタデータのprobeなど。変わるのはエンドポイントとparamsだけで、認証ヘッダーとレスポンスの形式はそのままです。

CloudinaryやTransloaditではなく、なぜFotovidなのですか?

それらはスタック全体を組み立てる前提のフルメディアプラットフォームです。Fotovidは、バイナリを起動できないisolateからfetch()で呼び出す、単機能のffmpegマイクロサービスです。操作ごとに1つのエンドポイント、使った分だけのcredits($1 = 100 credits、ほとんどの操作は1 credit)、そしてアセットマネージャーやダッシュボードといった余計なものはありません。

Deno Deployでのffmpeg

なぜffmpegはDeno Deployで動かないのか？subprocessがないので、APIを呼びましょう。

Deno DeployはコードをV8 isolate上で実行するため、subprocessもFFIもなく、ffmpegバイナリを起動できません。代わりにfetch()経由でFotovidを呼び出しましょう。エンコードは別の場所で実行され、結果はシンプルなhttpsリンクとして返ってきます。

無料でAPIキーを取得ドキュメントを見る →

Deno.serve(async (req) => {
  const { videoUrl, logoUrl } = await req.json();

  const res = await fetch("https://api.fotovid.co/v1/video/watermark", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${Deno.env.get("FOTOVID_API_KEY")}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source_url: videoUrl,
      params: { type: "image", watermark_image_url: logoUrl, position: "bottom-right" },
    }),
  });

  const { url } = await res.json();
  return Response.json({ url });
});

isolateモデルではffmpegは一切動作しません

Deno Deployは高速なエッジロジック向けのV8 isolate上に構築されており、CPUを大量に使うメディアエンコード向けではありません。ネイティブバイナリを起動するsubprocess APIも、読み込むためのFFIも存在しないため、ffmpegプロセスはそもそも起動できません。これは設定フラグや付与できる権限の問題ではなく、ffmpegが必要とするプリミティブがisolateサンドボックスに存在しないという構造的な制約です。ffmpegのWebAssembly移植版も存在しますが、実際の動画を扱うとisolateのCPU・メモリ上限を大きく超えてしまい、大きなファイルをストリーム処理することもできません。

subprocessなし:isolate内ではDeno.Commandもchild_processもffmpegバイナリを起動できません。
FFIなし:ネイティブのffmpegライブラリをdlopenして直接呼び出すことはできません。
Wasm版ffmpegは実際の動画でisolateのCPU・メモリを使い果たし、大きな入力をストリーム処理できません。
このプラットフォームは短時間のエッジリクエスト向けに最適化されており、数秒に及ぶエンコードジョブ向けではありません。

Deno Deployでffmpegを動かそうとするチームの試み

Fotovid登場以前の選択肢は以下の通りです。どれも自分では抱えたくない作業ばかりです。

Option	What it costs you	Verdict
Deno Deploy関数にffmpegをバンドルする	ffmpegバイナリを起動するためのsubprocessがない
コンテナやVMを自前でホストする	常時稼働のコストに加え、パッチ適用・スケーリング・監視が必要
ジョブキュー+ワーカーを構築する	新たなインフラが必要:キュー、ワーカー、リトライ、デッドレター処理
ブラウザ内でトランスコードする（WASM）	遅くてメモリを大量消費し、モバイルではクラッシュする
Fotovid APIを呼び出す	HTTPSリクエスト1回だけ。実行・パッケージ化・スケーリングは不要

How it works

最初の呼び出しまで、たったの3ステップ

1
無料のAPIキーを取得する
サインアップしてキーを作成しましょう。最初はクレジットカード不要です。取得したkey IDとsecretを組み合わせると、p6_<key_id>:<secret>という形式のBearerトークンになります。これをDeno Deployの環境変数に保存すれば、バイナリを一切配布することなくisolateから認証できます。
2
ウォーターマークエンドポイントにPOSTする
Denoのハンドラから、Bearerトークンを付けて通常のfetchでhttps://api.fotovid.co/v1/video/watermarkにPOSTします。送るのは標準のエンベロープです。入力動画のHTTPS URLを指すsource_urlと、ウォーターマークの内容を記述するparamsオブジェクトを含めます。paramsにはtype(image、text、combo)、watermark_image_urlまたはtext、position(bottom-rightなど)、opacity、scaleを指定します。Fotovidがソースを取得し、自社インフラ上でffmpegを実行し、あなたのisolateがタイムアウトする前に応答を返します。
3
返ってきたURLを使う
レスポンスはフラットなJSONで、id、type、完成した動画を指すFotovidホストのurl、さらにexpires_atとdurationが含まれます。このurlをそのままクライアントに渡すか、サーバー側で取得して既存のバケットに自分のコピーとして保存してください。ほとんどの操作は1 creditなので、ウォーターマークの呼び出しは残高から1 credit消費するだけです。

よくある質問

さらに見る

Serverless ffmpeg — all guides Vercel上のffmpeg Netlify Functions で ffmpeg を使う透かし操作動画処理ドキュメント

1回のAPI呼び出しでリリース

無料のキーを取得し、5分以内に最初の呼び出しを試せます。

無料でAPIキーを取得