Files and outputs - ffmpeg-api-cloud

API は 2 つの入力パターンをサポートします。

先に /v1/files でファイルをアップロードし、その asset ID をジョブで参照する。
ジョブリクエストに公開 URL を直接渡す。

アップロードフロー

POST /v1/files でアップロードスロットを作成します。
返された uploadUrl にバイト列をアップロードします。
POST /v1/jobs から返されたファイル ID を参照します。

URL フロー

ソースファイルがすでに HTTP で公開されている場合は、input 配列に URL を渡します。

出力

FFmpeg ジョブでは、outputs に名前付き出力を定義し、それを ffmpegArgs から参照します。

{
  "outputs": {
    "thumbnail": {
      "fileName": "frame.jpg",
      "contentType": "image/jpeg"
    }
  },
  "ffmpegArgs": [
    "-i",
    "input0",
    "-frames:v",
    "1",
    "{{thumbnail}}"
  ]
}

FFprobe ジョブは JSON を返すため、ファイル出力を事前定義する必要はありません。